Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes