Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

thrd_sleep — suspender a thread que faz a chamada

thrd_sleep suspende a thread que faz a chamada durante o intervalo pedido. Um sinal pode interromper a espera e o escalonamento pode prolongá-la.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

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

thrd_sleep de <threads.h> recebe um intervalo, não um prazo: duration aponta para uma struct timespec com os segundos em tv_sec e os nanossegundos em tv_nsec.

remaining pode ser NULL; se um sinal interromper a espera, recebe o intervalo restante. Ambos os apontadores podem designar o mesmo objeto.

O valor de retorno 0 significa que o intervalo pedido decorreu. Se um sinal interromper a espera, a função devolve -1. Em caso de falha, devolve um valor negativo que também pode ser -1. Assim, -1 por si só não permite saber se um sinal interrompeu a espera; não parta do princípio de que é seguro tentar novamente com base apenas nesse valor.

Sem interrupção, a espera não é inferior à pedida segundo TIME_UTC, mas a resolução do relógio e o escalonamento podem prolongá-la.

Exemplos

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

Resultado

Sleep completed.

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes