pcntl_sigtimedwait
PHP function
Edit on GitHub ✎
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
Waits for signals, with a timeout
Description
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
signalsArray of signals to wait for.
infoThe
infois set to an array containing information about the signal. Seepcntl_sigwaitinfo().secondsTimeout in seconds.
nanosecondsTimeout in nanoseconds.
Return Values
pcntl_sigtimedwait() returns a signal number on success, Falseforfailure.
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. |