CKTIS / C
thrd_sleep — pozastavení volajícího vlákna
thrd_sleep pozastaví volající vlákno na požadovanou dobu. Signál může čekání přerušit a plánování vláken je může prodloužit.
Verze: C23; repository compiler flag, production runtime not attested
Syntaxe
#include <threads.h>
int thrd_sleep(const struct timespec *duration, struct timespec *remaining);thrd_sleep z <threads.h> přijímá dobu trvání, nikoli termín: duration ukazuje na struct timespec se sekundami v tv_sec a nanosekundami v tv_nsec.
remaining může být NULL; při přerušení signálem do něj bude uložena zbývající doba. Oba ukazatele mohou označovat stejný objekt.
Návratová hodnota 0 znamená, že požadovaná doba uplynula. Pokud čekání přeruší signál, funkce vrátí -1. Při chybě vrátí zápornou hodnotu, která může být rovněž -1. Ze samotné hodnoty -1 tedy nelze poznat, zda čekání přerušil signál. Jen na základě této hodnoty nepředpokládejte, že lze čekání bezpečně zopakovat.
Bez přerušení není čekání podle TIME_UTC kratší než požadovaná doba, ale rozlišení hodin a plánování vláken je mohou prodloužit.
Pří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ýsledek
Sleep completed.
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.