sleep

(PHP 4, PHP 5, PHP 7)

sleepProgrammverzögerung

Beschreibung

sleep ( int $seconds ) : int

Unterbricht die weitere Skript-Ausführung für die angegebene Anzahl von Sekunden.

Parameter-Liste

seconds

Die Unterbrechung in Sekunden

Rückgabewerte

Gibt bei Erfolg null oder im Fehlerfall FALSE zurück.

Wenn der Aufruf durch ein Signal unterbrochen wurde, gibt sleep() eine positive Zahl zurück. Auf Windows ist dieser Wert immer 192 (der Wert der WAIT_IO_COMPLETION Konstanten der Windows API). Auf anderen Plattformen ist der Rückgabewert die Anzahl der Sekunden die das Programm eigentlich noch "schlafen" sollte.

Fehler/Exceptions

Falls die angegebene Anzahl von Sekunden negativ ist, erzeugt diese Funktion einen Fehler des Typs E_WARNING.

Changelog

Version Beschreibung
5.3.4 Vor PHP 5.3.4, hat sleep() auf Windows immer NULL zurückgegeben, unabhängig davon ob der Aufruf unterbrochen wurde oder nicht.

Beispiele

Beispiel #1 sleep()-Beispiel

<?php
// die aktuelle Zeit
echo date('h:i:s') . "\n";

// 10 Sekunden schlafen
sleep(10);

// aufwachen!
echo date('h:i:s') . "\n";
?>

Dieses Beispiel erzeugt nach zehn Sekunden die Ausgabe

05:31:23
05:31:33

Siehe auch