time_nanosleep
(PHP 5, PHP 7)
time_nanosleep — 秒およびナノ秒単位で実行を遅延する
説明
指定した seconds および
nanoseconds の時間だけプログラムの実行を遅延させます。
パラメータ
-
seconds -
非負の整数である必要があります。
-
nanoseconds -
十億よりも小さい非負の整数である必要があります。
返り値
成功した場合に TRUE を、失敗した場合に FALSE を返します。
シグナルによって遅延処理が中断された場合、以下の要素からなる連想配列を返します。
- seconds - 残りの秒数
- nanoseconds - 残りのナノ秒数
変更履歴
| バージョン | 説明 |
|---|---|
| 5.3.0 | この関数は Windows プラットフォームでも使用可能となりました。 |
例
例1 time_nanosleep() の例
<?php
// 注意! もし配列が返された場合、これはうまく動作しません
if (time_nanosleep(0, 500000000)) {
echo "0.5 秒遅延しました。\n";
}
// こちらのほうがよいでしょう
if (time_nanosleep(0, 500000000) === true) {
echo "0.5 秒遅延しました。\n";
}
// そしてこれが最良の方法です
$nano = time_nanosleep(2, 100000);
if ($nano === true) {
echo "2 秒と 100 マイクロ秒だけ遅延しました。\n";
} elseif ($nano === false) {
echo "遅延に失敗しました。\n";
} elseif (is_array($nano)) {
$seconds = $nano['seconds'];
$nanoseconds = $nano['nanoseconds'];
echo "シグナルによって中断しました。\n";
echo "残りの秒数は $seconds 秒と $nanoseconds ナノ秒です。";
}
?>
参考
- sleep() - 実行を遅延させる
- usleep() - マイクロ秒単位で実行を遅延する
- time_sleep_until() - 指定した時刻まで実行を遅延する
- set_time_limit() - 実行時間の最大値を制限する
忘却曲線を使ってこの関数を確実に記憶に残す
