pcntl_sigtimedwait

Waits for signals, with a timeout

&reftitle.description; ``int``false```pcntl_sigtimedwait` `array` `signals` `array` `info`[] `int` `seconds` 0 `int` `nanoseconds` 0

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.

&reftitle.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.

&reftitle.returnvalues;

`pcntl_sigtimedwait` returns a signal number on success, &return.falseforfailure;.

&reftitle.changelog;

&Version; | &Description;
8.4.0 | A `ValueError` is thrown if `signal` is empty.
8.4.0 | A `TypeError` is thrown if `signal` value is not an `int`.
8.4.0 | A `ValueError` is thrown if `signal` 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 less than `0`.
8.4.0 | A `ValueError` is thrown if both `seconds` and `nanoseconds` values are `0`.

&reftitle.seealso;

- `pcntl_sigprocmask`
- `pcntl_sigwaitinfo`