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.