PHP Manual: pcntl_sigtimedwait

Description

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

The pcntl_sigtimedwait() function operates in exactly the same way as pcntl_sigwaitinfo() except that it takes two additional parameters, seconds and nanoseconds, which enable an upper bound to be placed on the time for which the script is suspended.

Parameters

signals: Array of signals to wait for.
info: The info is set to an array containing information about the signal. See pcntl_sigwaitinfo().
seconds: Timeout in seconds.
nanoseconds: Timeout in nanoseconds.

Return Values

pcntl_sigtimedwait() returns a signal number on success, or false on failure.

Changelog

Version	Description
8.4.0	On failure, `false` is now returned; previously `-1` was returned in some cases.
8.4.0	A ValueError is thrown if `signals` is empty.
8.4.0	A TypeError is thrown if `signals` value is not an int.
8.4.0	A ValueError is thrown if `signals` value is invalid.
8.4.0	A ValueError is thrown if `seconds` value is less than `0`.
8.4.0	A ValueError is thrown if `nanoseconds` value is not between `0` and `1e9`.
8.4.0	A ValueError is thrown if both `seconds` and `nanoseconds` values are `0`.

pcntl_sigtimedwait

Description

Parameters

Return Values

Changelog

See Also