PHP | función time_nanosleep( )

La función time_nanosleep() en PHP es una función incorporada que se utiliza para retrasar la ejecución del script actual durante un número específico de segundos y nanosegundos.

La función time_nanosleep() acepta segundos y nanosegundos como parámetros y devuelve VERDADERO en caso de éxito o FALSO en caso de error.

Si el retardo es interrumpido por una señal, se devuelve una array asociativa con los siguientes componentes:

1. segundos: indica el número de segundos restantes en el retraso.
2. nanosegundos: Denota el número de nanosegundos restantes en el retardo.

Sintaxis:

time_nanosleep(seconds, nanoseconds)

Parámetros usados:
La función time_nanosleep() en PHP acepta dos parámetros.

• segundos : Es un parámetro obligatorio que especifica la cantidad de segundos.
• nanosegundos : Es un parámetro obligatorio que especifica el número de nanosegundos.

Valor devuelto: Devuelve VERDADERO en caso de éxito o FALSO en caso de fallo. Si el retardo es interrumpido por una señal, se devuelve una array asociativa con los segundos y nanosegundos restantes.

Errores y excepciones :

1. El valor de nanosegundos pasado como parámetro debe ser menor a 1, 000, 000, 000.
2. El valor de los segundos pasados ​​como parámetro no debe ser negativo.

Los siguientes programas ilustran la función time_nanosleep():

Programa 1 :

<?php
// displaying time
if (time_nanosleep(2, 500000000) === true)
{
   echo "Execution delayed for two and half a second";
}
else 
{
   echo "No delay in Execution";
}
?>

Producción:

Execution delayed for two and  half a second

Programa 2 :

<?php
// displaying time
echo date('h:i:s');
  
// delaying execution of the script for 2 seconds and half a second
time_nanosleep(2, 500000000);
  
// displaying time again
echo ("\n");
echo date('h:i:s'); 
?>

Producción:

06:45:15
06:45:18

Referencia: http://php.net/manual/en/function.time-nanosleep.php