CKTIS / C
thrd_sleep — začasna ustavitev klicne niti
thrd_sleep začasno ustavi klicno nit za zahtevani časovni interval. Signal lahko prekine čakanje, razporejanje pa ga lahko podaljša.
Različica: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <threads.h>
int thrd_sleep(const struct timespec *duration, struct timespec *remaining);thrd_sleep iz <threads.h> sprejme časovni interval, ne roka: duration kaže na struct timespec s sekundami v tv_sec in nanosekundami v tv_nsec.
remaining je lahko NULL; če čakanje prekine signal, prejme preostali časovni interval. Oba kazalca lahko označujeta isti objekt.
Vrnjena vrednost 0 pomeni, da je zahtevani interval potekel. Če signal prekine čakanje, funkcija vrne -1. Ob napaki vrne negativno vrednost, ki je prav tako lahko -1. Zgolj iz vrednosti -1 torej ni mogoče ugotoviti, ali je čakanje prekinil signal. Ne sklepajte samo na podlagi te vrednosti, da je čakanje varno ponoviti.
Brez prekinitve čakanje po TIME_UTC ni krajše od zahtevanega, vendar ga lahko podaljšata ločljivost ure in razporejanje.
Primeri
#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;
}
Rezultat
Sleep completed.
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.