Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje