PHP-Handbuch: Programmverzögerung

Beschreibung

int sleep ( int $seconds )

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

usleep
time_nanosleep
time_sleep_until
set_time_limit