Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

thrd_sleep — začasna ustavitev klicne niti

thrd_sleep začasno ustavi klicno nit za zahtevani časovni interval. Signal lahko prekine čakanje, razporejanje pa ga lahko podaljša.

Različica: 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> sprejme časovni interval, ne roka: duration kaže na struct timespec s sekundami v tv_sec in nanosekundami v tv_nsec.

remaining je lahko NULL; če čakanje prekine signal, prejme preostali časovni interval. Oba kazalca lahko označujeta isti objekt.

Vrnjena vrednost 0 pomeni, da je zahtevani interval potekel. Če signal prekine čakanje, funkcija vrne -1. Ob napaki vrne negativno vrednost, ki je prav tako lahko -1. Zgolj iz vrednosti -1 torej ni mogoče ugotoviti, ali je čakanje prekinil signal. Ne sklepajte samo na podlagi te vrednosti, da je čakanje varno ponoviti.

Brez prekinitve čakanje po TIME_UTC ni krajše od zahtevanega, vendar ga lahko podaljšata ločljivost ure in razporejanje.

Primeri

#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.

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri