sleep
(PHP 4, PHP 5)
sleep — Programmverzögerung
Beschreibung
$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() - Programm-Verzögerung in Mikrosekunden
- time_nanosleep() - Verzögert die Ausführung um die gegebene Anzahl Sekunden und Nanosekunden
- time_sleep_until() - Lässt das Skript bis zur angegebenen Zeit schlafen
- set_time_limit() - Beschränkt die maximale Ausführungszeit