CKTIS / C
thrd_sleep — pozastavenie volajúceho vlákna
thrd_sleep pozastaví volajúce vlákno na požadovaný časový interval. Signál môže čakanie prerušiť a plánovanie vlákien ho môže predĺžiť.
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <threads.h>
int thrd_sleep(const struct timespec *duration, struct timespec *remaining);thrd_sleep z <threads.h> prijíma časový interval, nie termín: duration ukazuje na struct timespec so sekundami v tv_sec a nanosekundami v tv_nsec.
remaining môže byť NULL; pri prerušení signálom doň uloží zostávajúci interval. Oba ukazovatele môžu označovať ten istý objekt.
Návratová hodnota 0 znamená, že požadovaný interval uplynul. Ak čakanie preruší signál, funkcia vráti -1. Pri chybe vráti zápornú hodnotu, ktorá môže byť tiež -1. Zo samotnej hodnoty -1 teda nemožno zistiť, či čakanie prerušil signál. Len na základe tejto hodnoty nepredpokladajte, že čakanie možno bezpečne zopakovať.
Bez prerušenia nie je čakanie podľa TIME_UTC kratšie než požadovaný interval, no rozlíšenie hodín a plánovanie vlákien ho môžu predĺžiť.
Príklady
#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;
}
Výsledok
Sleep completed.
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.