CKTIS / C++
thread_local — eine eigene Variable für jeden Thread
Das Schlüsselwort thread_local gibt einer Variablen eine Thread-Speicherdauer: Jeder Thread besitzt eine eigene Instanz, die zwischen Funktionsaufrufen erhalten bleibt. Es entsteht keine gemeinsame Variable, die vor gleichzeitigem Zugriff geschützt wäre.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
thread_local T name = initializer;
static thread_local T name = initializer;
extern thread_local T name;thread_local gibt einer Variablen eine Thread-Speicherdauer. Jeder Thread hat eine eigene Instanz; die Verwendung des Namens bezieht sich auf die Instanz des aktuellen Threads. Eine lokale Variable dieser Art behält ihren Wert zwischen Funktionsaufrufen im selben Thread. Eine gewöhnliche automatische Variable tut dies nicht; eine lokale static-Variable ohne thread_local ist dagegen bei Aufrufen aus verschiedenen Threads gemeinsam.
In C++23 kann der Spezifizierer für Variablen auf Namespace-Ebene, Variablen auf Blockebene und statische Datenelemente einer Klasse verwendet werden, nicht aber für Funktionsparameter oder nicht-statische Datenelemente. Er kann mit static oder extern kombiniert werden; dadurch ändert sich die Thread-Speicherdauer nicht. Jede Deklaration derselben Variablen muss thread_local enthalten.
Die dynamische Initialisierung einer lokalen thread_local-Variablen erfolgt zum ersten Mal, wenn die Ausführung in diesem Thread ihre Deklaration erreicht. Übertrage diese Regel nicht auf die Initialisierung aller Variablen auf Namespace-Ebene. Ein konstruiertes Objekt wird beim regulären Beenden seines Threads zerstört, nicht bei der Rückkehr aus der Funktion. Verwende keinen Zeiger und keine Referenz darauf, nachdem seine Lebensdauer beendet ist.
thread_local ist weder eine Sperre noch eine atomare Operation. Wird ein Zeiger auf eine bestimmte Instanz mit einem anderen Thread geteilt, entsteht dadurch weder eine neue Kopie noch Synchronisierung. Im Beispiel erhöht jeder Thread sein eigenes count; join() stellt sicher, dass der Worker beendet ist, bevor seine Ergebnisse gelesen werden, sodass die erwartete Ausgabe deterministisch ist.
Dieser Eintrag bezieht sich auf C++23. Die angegebene Quellwebsite enthält einen fortlaufend weiterentwickelten Arbeitsentwurf und keine endgültige C++23-Veröffentlichung. Ein Compiler-Flag ist kein Nachweis für den Betrieb in einer Produktionsumgebung.
Beispiele
#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';
}
Ergebnis
1 2 1 2 3
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.