PHP 8.1.0 RC 4 available for testing

time_nanosleep

(PHP 5, PHP 7, PHP 8)

time_nanosleep Verzögert die Ausführung um die gegebene Anzahl Sekunden und Nanosekunden

Beschreibung

time_nanosleep(int $seconds, int $nanoseconds): array|bool

Verzögert die Ausführung um die angegebene Anzahl Sekunden (seconds) und Nanosekunden (nanoseconds).

Parameter-Liste

seconds

Muss eine nichtnegative Ganzzahl sein.

nanoseconds

Muss eine nichtnegative Ganzzahl kleiner eine Milliarde sein.

Hinweis: Unter Windows kann das System abhängig von der Hardware länger anhalten als die angegebene Anzahl von Nanosekunden.

Rückgabewerte

Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

Wenn die Verzögerung durch ein Signal unterbrochen wurde, wird ein assoziatives Array mit den folgenden Werten zurückgegeben:

  • seconds - die Anzahl verbleibender Sekunden
  • nanoseconds - die Anzahl verbleibender Nanosekunden

Beispiele

Beispiel #1 time_nanosleep()-Beispiel

<?php
// Vorsicht! Verhält sich nicht wie erwartet, wenn ein Array
// zurückgegeben wird
if (time_nanosleep(0500000000)) {
    echo 
"Verzögerung um eine halbe Sekunde.\n";
}

// Dies ist besser:
if (time_nanosleep(0500000000) === true) {
    echo 
"Verzögerung um eine halbe Sekunde.\n";
}

// Optimal ist:
$nano time_nanosleep(2100000);

if (
$nano === true) {
    echo 
"Verzögert um 2 Sekunden und  100 Millisekunden.\n";
} elseif (
$nano === false) {
    echo 
"Keine Verzögerung.\n";
} elseif (
is_array($nano)) {
    
$seconds $nano['seconds'];
    
$nanoseconds $nano['nanoseconds'];
    echo 
"Von einem Signal unterbrochen.\n";
    echo 
"Verbleibende Verzögerung: $seconds Sekunden, $nanoseconds Nanosekunden.";
}
?>

Siehe auch

  • sleep() - Verzögert die Programmausführung
  • usleep() - Verzögert die Programmausführung (in Mikrosekunden)
  • time_sleep_until() - Lässt das Skript bis zur angegebenen Zeit schlafen
  • set_time_limit() - Beschränkt die maximale Ausführungszeit

add a note add a note

User Contributed Notes 5 notes

up
5
m at kufi dot net
16 years ago
You should take into account, if you use the function replacement down here, the CPU will be in use of 99% for the time of execution...

(A little bit better in this situation is to let the 'full seconds' go by a normal sleep command (makes the thread sleep!, and uses minimum cpu))

<?php
   
//THIS IS THE FUNCTION WE ARE TALKIN ABOUT
   
function timeWait($microtime)
    {
//optimizations added by me [start]
//sleep the full seconds
sleep(intval($microtime));
//set the microtime to only resleep the last part of the nanos
$microtime = $microtime - intval($microtime);
//optimizations added by me [end]

       
$timeLimit = $microtime + array_sum(explode(" ",microtime()));
        while(
array_sum(explode(" ",microtime())) < $timeLimit)
        {
/*DO NOTHING*/}
        return(
true);
    }

   
//THIS IS HOW WE CAN USE IT
   
echo "Process started at " . date("H:i:s") . " and " . current(explode(" ",microtime())) . " nanoseconds.<br>";
   
timeWait(5.5); //With this call the system will wait 5 seconds and a half. You can use either integer or float.
   
echo "Process completed at " . date("H:i:s") . " and " . current(explode(" ",microtime())) . " nanoseconds.";
?>
up
8
anybody (a) emuxperts.net
15 years ago
Documentation states that "seconds" must be positive. This is not correct, 0 is possible.

Rather, "seconds" must be non-negative.
up
7
fantasysportswire at yahoo dot com
14 years ago
Just glancing at this - and the note from over a year ago with a implementation for windows.. with 5.0.0 and higher it would be simplier to just do something like......

<?php

if (!function_exists('time_nanosleep')) {

function
time_nanosleep($seconds, $nanoseconds) {

sleep($seconds);
usleep(round($nanoseconds/100));

return
true;

}

}

?>

....off the top of my head - obviously simple enough there should be no mistakes.. but those are the ones that always seem to get ya :( .....
up
2
b dot andrew at shaw dot ca
13 years ago
A response to the note below:

Your function is also useless, as the WinNT 32 kernel only functions at a minimum of about 10+ ms (1,000 us), rendering usleep() useless, because usleep uses the C function which is provided by the system (in this case, kernel32.dll).

You'll want to use a function that does not rely on the kernel, but rather something made for precise measurement:

<?php
function usleep_win( $micro_seconds )
{
    if ( @
function_exists( "socket_create" ) && @function_exists( "socket_select" ) )
    {
       
$false = NULL;
       
$socket = array( socket_create( AF_INET, SOCK_RAW, $false ) );
       
socket_select( $false, $false, $socket, 0, $micro_seconds );
        return
true;
    }
    else
    {
        return
false;
    }
}
?>

This function will allow to you sleep for a specified microsecond, although I have measured it to be off by ~5 us.

Again, most of this depends on the hardware in your system. If you _REALLY_ need to be precise to < 10 us, you shouldn't be using WinNT anyways!
up
-6
tecnomaniac at ig dot com dot br
16 years ago
This is an alternative function to sleep_nanosecond that you can use with PHP versions below PHP 5.0. It is not very accurate if we talk about nanoseconds but the results are satisfatory. Enjoy!

<?php
   
//THIS IS THE FUNCTION WE ARE TALKIN ABOUT
   
function timeWait($microtime)
    {
       
$timeLimit = $microtime + array_sum(explode(" ",microtime()));
        while(
array_sum(explode(" ",microtime())) < $timeLimit)
        {
/*DO NOTHING*/}
        return(
true);
    }

   
//THIS IS HOW WE CAN USE IT
   
echo "Process started at " . date("H:i:s") . " and " . current(explode(" ",microtime())) . " nanoseconds.<br>";
   
timeWait(5.5); //With this call the system will wait 5 seconds and a half. You can use either integer or float.
   
echo "Process completed at " . date("H:i:s") . " and " . current(explode(" ",microtime())) . " nanoseconds.";
?>
To Top