time_sleep_until(3) [php man page]

TIME_SLEEP_UNTIL(3)							 1						       TIME_SLEEP_UNTIL(3)

time_sleep_until - Make the script sleep until the specified time

SYNOPSIS

       bool time_sleep_until (float  $timestamp)

DESCRIPTION

	Makes the script sleep until the specified $timestamp.

PARAMETERS

	      o $timestamp
		- The timestamp when the script should wake.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.3.0	|						    |
       |	|						    |
       |	|  This  function is now available on Windows plat- |
       |	| forms.					    |
       |	|						    |
       +--------+---------------------------------------------------+
ERRORS
/EXCEPTIONS
	If the specified $timestamp is in the past, this function will generate a E_WARNING.

EXAMPLES

       Example #1

	      A time_sleep_until(3) example

	      <?php

	      //returns false and generates a warning
	      var_dump(time_sleep_until(time()-1));

	      // may only work on faster computers, will sleep up to 0.2 seconds
	      var_dump(time_sleep_until(microtime(true)+0.2));

	      ?>

NOTES

       Note

	       All signals will be delivered after the script wakes up.

SEE ALSO

       sleep(3), usleep(3), time_nanosleep(3), set_time_limit(3).

PHP Documentation Group 												       TIME_SLEEP_UNTIL(3)

TIME_NANOSLEEP(3)							 1							 TIME_NANOSLEEP(3)

time_nanosleep - Delay for a number of seconds and nanoseconds

SYNOPSIS

       mixed time_nanosleep (int  $seconds, int  $nanoseconds)

DESCRIPTION

	Delays program execution for the given number of $seconds and $nanoseconds.

PARAMETERS

	      o $seconds
		- Must be a non-negative integer.

	      o $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:

	      o seconds - number of seconds remaining in the delay

	      o nanoseconds - number of nanoseconds remaining in the delay

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.3.0	|						    |
       |	|						    |
       |	|  This  function is now available on Windows plat- |
       |	| forms.					    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      time_nanosleep(3) 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.
";
	      }

	      // This is better:
	      if (time_nanosleep(0, 500000000) === true) {
		  echo "Slept for half a second.
";
	      }

	      // And this is the best:
	      $nano = time_nanosleep(2, 100000);

	      if ($nano === true) {
		  echo "Slept for 2 seconds, 100 microseconds.
";
	      } elseif ($nano === false) {
		  echo "Sleeping failed.
";
	      } elseif (is_array($nano)) {
		  $seconds = $nano['seconds'];
		  $nanoseconds = $nano['nanoseconds'];
		  echo "Interrupted by a signal.
";
		  echo "Time remaining: $seconds seconds, $nanoseconds nanoseconds.";
	      }
	      ?>

SEE ALSO

       sleep(3), usleep(3), time_sleep_until(3), set_time_limit(3).

PHP Documentation Group 													 TIME_NANOSLEEP(3)