CKTIS / C
thrd_sleep — suspendre le thread appelant
thrd_sleep suspend le thread appelant pendant une durée donnée. Un signal peut interrompre l’attente, et l’ordonnancement peut la prolonger.
Version : C23; repository compiler flag, production runtime not attested
Syntaxe
#include <threads.h>
int thrd_sleep(const struct timespec *duration, struct timespec *remaining);thrd_sleep de <threads.h> prend une durée, et non une échéance : duration pointe vers une struct timespec contenant les secondes dans tv_sec et les nanosecondes dans tv_nsec.
remaining peut être NULL ; en cas d’interruption par un signal, il reçoit la durée restante. Les deux pointeurs peuvent désigner le même objet.
La valeur de retour 0 signifie que la durée demandée s’est écoulée. Si un signal interrompt l’attente, la fonction renvoie -1. En cas d’échec, elle renvoie une valeur négative qui peut aussi être -1. La valeur -1 ne suffit donc pas à établir qu’un signal a interrompu l’attente ; ne vous fiez pas à cette seule valeur pour relancer l’attente sans risque.
Sans interruption, l’attente n’est pas plus courte que la durée demandée selon TIME_UTC, mais la résolution de l’horloge et l’ordonnancement peuvent la prolonger.
Exemples
#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;
}
Résultat
Sleep completed.
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.