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.