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

CKTIS / C

thrd_join — attendre la fin d’un thread

thrd_join bloque le thread appelant jusqu’à la fin du thread indiqué et récupère éventuellement son résultat de type int. Le statut de l’opération est distinct du résultat du thread.

Version : C23; repository compiler flag, production runtime not attested

Syntaxe

#include <threads.h>
int thrd_join(thrd_t thr, int *res);

thrd_join, défini dans <threads.h>, attend que le thread thr se termine. Si res n’est pas nul, le résultat est enregistré à cette adresse ; avec NULL, le résultat n’est pas récupéré.

La fonction renvoie thrd_success ou thrd_error, et non le résultat du thread. Celui-ci provient de la valeur renvoyée par la fonction du thread ou de thrd_exit. Ne le lisez qu’après la réussite de l’appel.

La fin du thread est synchronisée avec l’achèvement de thrd_join. Le thread cible ne doit pas avoir déjà été détaché ou rejoint. Ne supposez pas que le non-respect de cette exigence renvoie thrd_error.

Exemples

#include <stdio.h>
#include <stdlib.h>
#include <threads.h>

static int worker(void *arg)
{
    (void)arg;
    return 42;
}

int main(void)
{
    thrd_t thread;
    int result;

    if (thrd_create(&thread, worker, NULL) != thrd_success)
        return EXIT_FAILURE;

    if (thrd_join(thread, &result) != thrd_success)
        return EXIT_FAILURE;

    printf("result = %d\n", result);
    return EXIT_SUCCESS;
}

Résultat

result = 42

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