CKTIS / C++
thread_local — une variable distincte pour chaque thread
Le mot-clé thread_local donne à une variable une durée de stockage propre au thread : chaque thread possède sa propre instance, conservée entre les appels de fonction. Il ne crée pas une variable partagée protégée contre les accès concurrents.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
thread_local T name = initializer;
static thread_local T name = initializer;
extern thread_local T name;thread_local donne à une variable une durée de stockage propre au thread. Chaque thread possède une instance distincte, et l’utilisation du nom désigne l’instance du thread courant. Une variable locale de ce type conserve sa valeur entre les appels de fonction dans le même thread. Une variable automatique ordinaire ne le fait pas, tandis qu’une variable locale static sans thread_local est partagée par les appels provenant de différents threads.
En C++23, le spécificateur peut être utilisé pour les variables à portée espace de noms, les variables à portée bloc et les membres de données statiques d’une classe, mais pas pour les paramètres de fonction ni les membres de données non statiques. Il peut être combiné avec static ou extern ; cela ne change pas sa durée de stockage propre au thread. Chaque déclaration de la même variable doit inclure thread_local.
L’initialisation dynamique d’une variable locale thread_local a lieu la première fois que l’exécution passe par sa déclaration dans ce thread. Ne généralisez pas cette règle à l’initialisation de toutes les variables à portée espace de noms. Un objet construit est détruit à la fin normale de son thread, et non au retour de la fonction. N’utilisez pas de pointeur ni de référence vers cet objet après la fin de sa durée de vie.
thread_local n’est ni un verrou ni une opération atomique. Partager avec un autre thread un pointeur vers une instance précise ne crée pas de nouvelle copie et ne fournit aucune synchronisation. Dans l’exemple, chaque thread incrémente son propre count ; join() garantit que le thread de travail a terminé avant la lecture de ses résultats, ce qui rend la sortie attendue déterministe.
Cette entrée concerne C++23. Le site source fourni héberge un projet de travail évolutif, et non une publication figée de C++23. Une option du compilateur ne prouve pas le bon fonctionnement dans un environnement de production.
Exemples
#include <iostream>
#include <thread>
int next() {
thread_local int count = 0;
return ++count;
}
int main() {
const int first = next();
const int second = next();
int workerFirst = 0;
int workerSecond = 0;
std::thread worker([&] {
workerFirst = next();
workerSecond = next();
});
worker.join();
std::cout << first << ' ' << second << '\n';
std::cout << workerFirst << ' ' << workerSecond << '\n';
std::cout << next() << '\n';
}
Résultat
1 2 1 2 3
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.