База знанияИзпитен център
BGБългарски
Избери език13

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.

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници