usleep

(PHP 4, PHP 5, PHP 7, PHP 8)

usleep — マイクロ秒単位で実行を遅延する

説明

usleep(int $microseconds): void

指定したマイクロ秒数だけプログラムの実行を遅延させます。

パラメータ

microseconds: 実行を停止するマイクロ秒数。マイクロ秒とは、一秒の百万分の一です。

注意: 1000000 より大きな値を指定すること (つまり、1秒以上スリープさせること) は、オペレーティングシステムによってはサポートしていないかもしれません。その場合は、sleep() を代わりに使ってください。

注意: スリープする時間は、わずかに長く (つまり、 microseconds 以上に) なる可能性があります。これは、システムの動作、呼び出し処理に時間が掛かること、およびシステムタイマの精度が原因です。

戻り値

値を返しません。

例

例1 usleep() の例

<?php

// 現在の時刻
echo (new DateTime('now'))->format('H:i:s.v'), "\n";

// 2 ミリ秒待つ
usleep(2000);

// 復帰!
echo (new DateTime('now'))->format('H:i:s.v'), "\n";

// 30 ミリ秒待つ
usleep(30000);

// 再び復帰!
echo (new DateTime('now'))->format('H:i:s.v'), "\n";

?>

上の例の出力は以下となります。

11:13:28.005
11:13:28.007
11:13:28.037

参考

sleep() - 実行を遅延させる
time_nanosleep() - 秒およびナノ秒単位で実行を遅延する
time_sleep_until() - 指定した時刻まで実行を遅延する
set_time_limit() - 実行時間の最大値を制限する