CKTIS / C
thrd_sleep — временно спиране на извикващата нишка
thrd_sleep временно спира извикващата нишка за зададен интервал. Сигнал може да прекъсне изчакването, а планирането може да го удължи.
Версия: C23; repository compiler flag, production runtime not attested
Синтаксис
#include <threads.h>
int thrd_sleep(const struct timespec *duration, struct timespec *remaining);thrd_sleep от <threads.h> приема интервал, а не краен срок: duration сочи към struct timespec, съдържаща секунди в tv_sec и наносекунди в tv_nsec.
remaining може да бъде NULL; ако сигнал прекъсне изчакването, в него се записва оставащият интервал. И двата указателя могат да сочат към един и същ обект.
Върнатата стойност 0 означава, че зададеният интервал е изтекъл. Ако сигнал прекъсне изчакването, функцията връща -1. При грешка тя връща отрицателна стойност, която също може да е -1. Затова само по стойността -1 не може да се установи дали сигнал е прекъснал изчакването. Не приемайте само въз основа на тази стойност, че е безопасно да повторите изчакването.
Без прекъсване изчакването според TIME_UTC не е по-кратко от заявеното, но разделителната способност на часовника и планирането могат да го удължат.
Примери
#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;
}
Резултат
Sleep completed.
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.