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

CKTIS / C

thread_local — un objet distinct pour chaque thread

thread_local confère à un objet une durée de stockage liée au thread. _Thread_local reste une graphie équivalente, mais obsolète.

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

Syntaxe

thread_local int counter = 0;
static thread_local int private_counter = 0;
extern thread_local int external_counter;
/* At block scope: */
/* static thread_local int local_counter = 0; */
/* Obsolescent equivalent spelling: _Thread_local */

thread_local est un mot-clé de C23 qui ne nécessite aucun en-tête. Chaque thread possède un objet distinct, qui existe pendant toute l'exécution de ce thread. _Thread_local est une graphie équivalente, mais obsolète.

Au niveau d'un bloc, static ou extern est également requis ; chaque déclaration du même objet doit conserver thread_local. Le spécificateur ne peut pas servir à déclarer des fonctions. L'initialisation a lieu au démarrage du thread, et non à chaque appel de fonction.

Un accès indirect depuis un autre thread a un comportement défini par l'implémentation. L'exemple montre la persistance entre les appels, et non l'isolation entre les threads.

Exemples

#include <stdio.h>

static int next(void)
{
    static thread_local int counter = 0;
    return ++counter;
}

int main(void)
{
    int first = next();
    int second = next();
    printf("%d %d\n", first, second);
    return 0;
}

Résultat

1 2

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