time_nanosleep(3) [php man page]

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)

DTK_NANOSLEEP(3)						Draw Toolkit manual						  DTK_NANOSLEEP(3)

NAME

       dtk_nanosleep - high-resolution sleep

SYNOPSIS

       #include <dtk_time.h>

       int dtk_nanosleep(int abs, const struct dtk_timespec* req,
				  struct dtk_timespec* rem);

DESCRIPTION

       The  function dtk_nanosleep() allows the caller to sleep for an interval with nanosecond precision. If the argument abs is zero, the speci-
       fied interval is interpretated as a relative value, otherwise an absolute value. The interval is specified by the req argument which  is  a
       pointer to a dtk_timespec structure defined as:

	   struct dtk_timespec {
	       long sec;    /* seconds */
	       long nsec;   /* nanoseconds */
	   };

       If interpreted as an absolute value, it represents seconds and nanoseconds since the Epoch, 1970-01-01 00:00:00 +0000  (UTC).

       dtk_nanosleep()	suspends  the  execution of the calling thread until either at least the time specified by req has elapsed, or a signal is
       delivered that causes a signal handler to be called or that terminates the process.

       If the call is interrupted by a signal handler, dtk_nanosleep() returns -1, and sets errno to EINTR. In addition, if rem is not	NULL,  and
       abs  is zero, it returns the remaining unslept time in rem. This value can then be used to call dtk_nanosleep() again and complete a (rela-
       tive) sleep.

RETURN VALUE

       On successfully sleeping for the requested interval, dtk_nanosleep() returns 0. If the call is interrupted by a signal handler  or  encoun-
       ters an error, then it returns -1 and errno is set appropriately.

ERRORS

       dtk_nanosleep() will fail if:

       EINTR  The sleep was interrupted by a signal handler.

       EINVAL The value in the nsec field was not in the range 0 to 999999999 or sec was negative.

NOTE

       This  function is a wrapper to clock_nanosleep(2) if it is provided by the system. Otherwise, it implements the function by using the sleep
       function with the highest precision available on the system.

SEE ALSO

       dtk_nanosleep(3), clock_nanosleep(2)

EPFL
								       2011							  DTK_NANOSLEEP(3)