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.