pcntl_sigtimedwait

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

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

説明

function pcntl_sigtimedwait(
    array $signals,
    array &$info = [],
    int $seconds = 0,
    int $nanoseconds = 0
): int|false

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

パラメータ

signals

待つシグナルの配列。

info

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

seconds

タイムアウトの秒数。

nanoseconds

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

戻り値

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

変更履歴

バージョン 説明
8.4.0 失敗時に false を返すようになりました。 これより前のバージョンでは、場合によっては -1 を返すことがありました。
8.4.0 signals が空の場合、 ValueError をスローするようになりました。
8.4.0 signals の値が int でない場合、 TypeError をスローするようになりました。
8.4.0 signals の値が無効である場合、 ValueError をスローするようになりました。
8.4.0 seconds が 0 未満である場合、 ValueError をスローするようになりました。
8.4.0 nanoseconds が 0 と 1e9 の間にない場合、 ValueError をスローするようになりました。
8.4.0 seconds と nanoseconds の両方が 0 である場合、 ValueError をスローするようになりました。

参考

+add a note

User Contributed Notes

There are no user contributed notes for this page.