CKTIS / C
thrd_sleep — privremeno zaustavljanje pozivajuće dretve
thrd_sleep privremeno zaustavlja pozivajuću dretvu na traženo vrijeme. Signal može prekinuti čekanje, a raspoređivanje ga može produljiti.
Verzija: 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> prima vremenski interval, a ne rok: duration pokazuje na struct timespec sa sekundama u tv_sec i nanosekundama u tv_nsec.
remaining može biti NULL; ako signal prekine čekanje, u njega se sprema preostali interval. Oba pokazivača mogu označavati isti objekt.
Povratna vrijednost 0 znači da je traženi interval istekao. Ako signal prekine čekanje, funkcija vraća -1. U slučaju pogreške vraća negativnu vrijednost koja također može biti -1. Iz same vrijednosti -1 stoga se ne može zaključiti je li signal prekinuo čekanje. Nemojte samo na temelju te vrijednosti pretpostaviti da je sigurno ponoviti čekanje.
Bez prekida čekanje prema TIME_UTC nije kraće od traženog, ali razlučivost sata i raspoređivanje mogu ga produljiti.
Primjeri
#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.
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.