Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje