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

# usleep

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

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

### 説明

function 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() - 実行時間の最大値を制限する

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open