pcntl_sigtimedwait

タイムアウトつきでシグナルを待つ

説明

intfalse pcntl_sigtimedwait(
    array $signals,
    array &$info = [],
    int $seconds = 0,
    int $nanoseconds = 0
)

pcntl_sigtimedwait 関数の挙動は pcntl_sigwaitinfo とほぼ同じですが、さらに 2 つのパラメータがあります。 seconds および nanoseconds がそれで、 スクリプトが待ち続ける時間の上限をここで設定することができます。

パラメータ

signals

待つシグナルの配列。

info

シグナルについての情報を含む配列が info に設定されます。 pcntl_sigwaitinfo を参照ください。

seconds

タイムアウトの秒数。

nanoseconds

タイムアウトのナノ秒数。

戻り値

成功した場合に pcntl_sigtimedwait はシグナル番号を返します。 失敗した場合に false を返します

変更履歴

バージョン 説明
8.4.0 signal が空の場合、 ValueError をスローするようになりました。
8.4.0 signal が int でない場合、 TypeError をスローするようになりました。
8.4.0 signal が無効である場合、 ValueError をスローするようになりました。
8.4.0 seconds が 0 未満である場合、 ValueError をスローするようになりました。
8.4.0 nanoseconds が 0 未満である場合、 ValueError をスローするようになりました。
8.4.0 seconds と nanoseconds の両方が 0 である場合、 ValueError をスローするようになりました。

参考

  • pcntl_sigprocmask
  • pcntl_sigwaitinfo