time_nanosleep
time_nanosleep
(PHP 5, PHP 7)
time_nanosleep — Delay for a number of seconds and nanoseconds
Description
mixed time_nanosleep ( int $seconds , int $nanoseconds )
Delays program execution for the given number of seconds
and nanoseconds
.
Parameters
-
seconds
-
Must be a non-negative integer.
-
nanoseconds
-
Must be a non-negative integer less than 1 billion.
Return Values
Returns TRUE
on success or FALSE
on failure.
If the delay was interrupted by a signal, an associative array will be returned with the components:
- seconds - number of seconds remaining in the delay
- nanoseconds - number of nanoseconds remaining in the delay
Changelog
Version | Description |
---|---|
5.3.0 | This function is now available on Windows platforms. |
Examples
Example #1 time_nanosleep() example
<?php // Careful! This won't work as expected if an array is returned if (time_nanosleep(0, 500000000)) { echo "Slept for half a second.\n"; } // This is better: if (time_nanosleep(0, 500000000) === true) { echo "Slept for half a second.\n"; } // And this is the best: $nano = time_nanosleep(2, 100000); if ($nano === true) { echo "Slept for 2 seconds, 100 microseconds.\n"; } elseif ($nano === false) { echo "Sleeping failed.\n"; } elseif (is_array($nano)) { $seconds = $nano['seconds']; $nanoseconds = $nano['nanoseconds']; echo "Interrupted by a signal.\n"; echo "Time remaining: $seconds seconds, $nanoseconds nanoseconds."; } ?>
See Also
- sleep() - Delay execution
- usleep() - Delay execution in microseconds
- time_sleep_until() - Make the script sleep until the specified time
- set_time_limit() - Limits the maximum execution time
© 1997–2017 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://secure.php.net/manual/en/function.time-nanosleep.php