Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

thrd_sleep — sospendere il thread chiamante

thrd_sleep sospende il thread chiamante per l’intervallo richiesto. Un segnale può interrompere l’attesa e la pianificazione può prolungarla.

Versione: C23; repository compiler flag, production runtime not attested

Sintassi

#include <threads.h>
int thrd_sleep(const struct timespec *duration, struct timespec *remaining);

thrd_sleep di <threads.h> accetta un intervallo, non una scadenza: duration punta a una struct timespec che contiene i secondi in tv_sec e i nanosecondi in tv_nsec.

remaining può essere NULL; se un segnale interrompe l’attesa, riceve l’intervallo rimanente. Entrambi i puntatori possono indicare lo stesso oggetto.

Il valore restituito 0 significa che l’intervallo richiesto è trascorso. Se un segnale interrompe l’attesa, la funzione restituisce -1. In caso di errore restituisce un valore negativo, che può essere anch’esso -1. Dal solo valore -1 non puoi quindi stabilire se un segnale ha interrotto l’attesa; non dare per scontato che sia sicuro riprovare sulla base di quel solo valore.

Senza interruzioni, secondo TIME_UTC l’attesa non è più breve di quella richiesta, ma la risoluzione dell’orologio e la pianificazione possono prolungarla.

Esempi

#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;
}

Risultato

Sleep completed.

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti