sleep
(PHP 4, PHP 5)
sleep — 実行を遅延させる
説明
int sleep
( int $seconds
)
seconds で与えられた秒数ぶんプログラムの実行を遅延させます。
パラメータ
- seconds
-
秒単位の停止時間。
返り値
成功した場合にゼロ、エラーが発生した場合に FALSE を返します。
シグナルで中断した場合、sleep() はゼロ以外の値を返します。 Windows では、この値は常に 192 (Windows API の定数 WAIT_IO_COMPLETION の値) です。 その他のプラットフォームでは、残りの遅延秒数を返します。
エラー / 例外
指定した秒数 seconds が負の場合、 この関数は E_WARNING を発生させます。
変更履歴
| バージョン | 説明 |
|---|---|
| 5.3.4 | PHP 5.3.4 より前のバージョンでは、Windows で sleep() を実行すると、遅延が発生したときには常に NULL を返していました。 処理が完了した場合もシグナルで中断した場合も同じです。 |
例
例1 sleep() の例
<?php
// 現在の時刻
echo date('h:i:s') . "\n";
// 10 秒間遅延させる
sleep(10);
// 再開!
echo date('h:i:s') . "\n";
?>
この例の（10 秒後の）出力は以下のようになります。
05:31:23 05:31:33
参考
- usleep() - マイクロ秒単位で実行を遅延する
- time_nanosleep() - 秒およびナノ秒単位で実行を遅延する
- time_sleep_until() - 指定した時刻まで実行を遅延する
- set_time_limit() - 実行時間の最大値を制限する
