CKTIS / C++
thread_local — oddzielna zmienna dla każdego wątku
Słowo kluczowe thread_local nadaje zmiennej wątkowy okres przechowywania: każdy wątek ma własną instancję, zachowywaną między wywołaniami funkcji. Nie jest to jedna wspólna zmienna chroniona przed równoczesnym dostępem.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
thread_local T name = initializer;
static thread_local T name = initializer;
extern thread_local T name;thread_local nadaje zmiennej wątkowy okres przechowywania. Każdy wątek ma odrębną instancję, a użycie nazwy wskazuje instancję bieżącego wątku. Lokalna zmienna tego rodzaju zachowuje wartość między wywołaniami funkcji w tym samym wątku; zwykła zmienna automatyczna nie ma tej właściwości, a lokalna zmienna static bez thread_local jest wspólna dla wywołań z różnych wątków.
W C++23 specyfikatora można używać dla zmiennych w przestrzeni nazw, zmiennych w bloku oraz statycznych składowych danych klasy, ale nie dla parametrów funkcji ani niestatycznych składowych danych. Można łączyć go z static lub extern; nie zmienia to wątkowego okresu przechowywania. Każda deklaracja tej samej zmiennej musi zawierać thread_local.
Dynamiczna inicjalizacja lokalnej zmiennej thread_local następuje przy pierwszym przejściu sterowania przez jej deklarację w danym wątku. Nie należy utożsamiać tego z regułami inicjalizacji wszystkich zmiennych w przestrzeni nazw. Skonstruowany obiekt jest niszczony przy zwykłym zakończeniu swojego wątku, nie przy wyjściu z funkcji. Nie używaj wskaźnika ani referencji do niego po zakończeniu jego czasu życia.
thread_local nie jest blokadą ani operacją atomową. Udostępnienie innemu wątkowi wskaźnika do konkretnej instancji nie tworzy nowej kopii i nie zapewnia synchronizacji. W przykładzie każdy wątek zwiększa własny count; join() zapewnia zakończenie pracy wątku roboczego przed odczytem wyników, więc oczekiwane wyjście jest deterministyczne.
Wpis dotyczy C++23. Podany serwis źródłowy zawiera rozwijany szkic standardu, a nie zamrożoną publikację C++23. Flaga kompilatora nie stanowi potwierdzenia działania w środowisku produkcyjnym.
Przykłady
#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';
}
Wynik
1 2 1 2 3
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.