CKTIS / C
thrd_sleep — suspender el hilo que realiza la llamada
thrd_sleep suspende el hilo que realiza la llamada durante el intervalo solicitado. Una señal puede interrumpir la espera y la planificación puede prolongarla.
Versión: C23; repository compiler flag, production runtime not attested
Sintaxis
#include <threads.h>
int thrd_sleep(const struct timespec *duration, struct timespec *remaining);thrd_sleep de <threads.h> recibe un intervalo, no una fecha límite: duration apunta a una struct timespec que contiene los segundos en tv_sec y los nanosegundos en tv_nsec.
remaining puede ser NULL; si una señal interrumpe la espera, recibe el intervalo restante. Ambos punteros pueden designar el mismo objeto.
El valor de retorno 0 significa que ha transcurrido el intervalo solicitado. Si una señal interrumpe la espera, la función devuelve -1. Si se produce un error, devuelve un valor negativo que también puede ser -1. Por tanto, -1 por sí solo no permite saber si una señal interrumpió la espera; no des por hecho que puedes volver a intentarlo sin riesgo basándote solo en ese valor.
Sin interrupciones, la espera no es más corta que la solicitada según TIME_UTC, pero la resolución del reloj y la planificación pueden prolongarla.
Ejemplos
#include <stdio.h>
#include <stdlib.h>
#include <threads.h>
#include <time.h>
int main(void)
{
const struct timespec duration = {
.tv_sec = 0,
.tv_nsec = 10000000L
};
if (thrd_sleep(&duration, NULL) != 0) {
fputs("Sleep did not complete.\n", stderr);
return EXIT_FAILURE;
}
puts("Sleep completed.");
return EXIT_SUCCESS;
}
Resultado
Sleep completed.
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.