Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

thrd_sleep — uśpienie bieżącego wątku

thrd_sleep wstrzymuje bieżący wątek na zadany okres. Sygnał może przerwać oczekiwanie, a planista może je wydłużyć.

Wersja: C23; repository compiler flag, production runtime not attested

Składnia

#include <threads.h>
int thrd_sleep(const struct timespec *duration, struct timespec *remaining);

thrd_sleep z <threads.h> przyjmuje okres, nie termin: duration wskazuje struct timespec z sekundami tv_sec i nanosekundami tv_nsec.

remaining może być NULL; przy przerwaniu sygnałem otrzymuje pozostały okres. Oba wskaźniki mogą wskazywać ten sam obiekt.

Wynik 0 oznacza, że żądany okres upłynął. Jeśli sygnał przerwie oczekiwanie, funkcja zwraca -1. W razie błędu zwraca wartość ujemną, która również może wynosić -1. Na podstawie samego -1 nie można więc stwierdzić, czy oczekiwanie przerwał sygnał; nie zakładaj, że można wtedy bezpiecznie ponowić oczekiwanie.

Bez przerwania sen nie jest krótszy niż żądano według TIME_UTC, ale rozdzielczość zegara i planista mogą go wydłużyć.

Przykłady

#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;
}

Wynik

Sleep completed.

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła