Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources