Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła