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

CKTIS / C

thrd_create — créer un thread

thrd_create lance func(arg) dans un nouveau thread et enregistre son identifiant via thr. L’appel renvoie le statut de création, et non le résultat de la fonction exécutée par le thread.

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

Syntaxe

#include <threads.h>
int thrd_create(thrd_t *thr, thrd_start_t func, void *arg);

thrd_create de <threads.h> crée un thread qui exécute func(arg). thr pointe vers l’emplacement où stocker son identifiant ; func est de type compatible avec int (*)(void *). Le pointeur arg est transmis, et non une copie de l’objet pointé.

La valeur de retour est thrd_success, thrd_nomem ou thrd_error. Le retour de func équivaut à un appel de thrd_exit avec son résultat. La fin de thrd_create est synchronisée avec le début du nouveau thread ; elle ne signifie pas que son travail est terminé.

Gardez les données de l’argument valides jusqu’à leur dernière utilisation. Récupérez le résultat avec thrd_join ; si vous n’avez pas besoin d’attendre, prévoyez un appel à thrd_detach. La création du thread, à elle seule, ne protège pas les accès concurrents ultérieurs aux données partagées.

Dans l’exemple, input reste valide pendant l’attente. La sortie attendue suppose que les deux opérations réussissent. Un indicateur de compilation C23 dans le dépôt ne garantit pas la disponibilité d’un environnement d’exécution des threads adapté à la production.

Exemples

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

static int worker(void *arg)
{
    return *(const int *)arg + 1;
}

int main(void)
{
    thrd_t thread;
    static int input = 41;
    int result;

    if (thrd_create(&thread, worker, &input) != thrd_success) {
        return EXIT_FAILURE;
    }
    if (thrd_join(thread, &result) != thrd_success) {
        return EXIT_FAILURE;
    }

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

Résultat

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