Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

thread_local — samostatná premenná pre každé vlákno

Kľúčové slovo thread_local dáva premennej dobu trvania úložiska vlákna: každé vlákno má vlastnú inštanciu, ktorá sa zachováva medzi volaniami funkcií. Nevytvára jednu zdieľanú premennú chránenú pred súbežným prístupom.

Verzia: 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 dáva premennej dobu trvania úložiska vlákna. Každé vlákno má samostatnú inštanciu a použitie názvu odkazuje na inštanciu aktuálneho vlákna. Lokálna premenná tohto druhu si zachováva hodnotu medzi volaniami funkcií v tom istom vlákne. Bežná automatická premenná to nerobí, zatiaľ čo lokálna premenná static bez thread_local je zdieľaná volaniami z rôznych vlákien.

V C++23 možno tento špecifikátor použiť pre premenné na úrovni menného priestoru, premenné na úrovni bloku a statické dátové členy triedy, nie však pre parametre funkcií ani nestatické dátové členy. Možno ho kombinovať s static alebo extern; tým sa doba trvania úložiska vlákna nemení. Každá deklarácia tej istej premennej musí obsahovať thread_local.

Dynamická inicializácia lokálnej premennej thread_local nastane prvýkrát, keď riadenie v danom vlákne prejde cez jej deklaráciu. Nevzťahujte toto pravidlo automaticky na inicializáciu všetkých premenných na úrovni menného priestoru. Vytvorený objekt sa zničí pri normálnom ukončení svojho vlákna, nie pri návrate z funkcie. Po skončení jeho životnosti nepoužívajte ukazovateľ ani referenciu naň.

thread_local nie je zámok ani atómová operácia. Zdieľanie ukazovateľa na konkrétnu inštanciu s iným vláknom nevytvorí novú kópiu ani nezabezpečí synchronizáciu. V príklade každé vlákno zvyšuje vlastné count; join() zabezpečí, že pracovné vlákno skončí pred prečítaním výsledkov, takže očakávaný výstup je deterministický.

Tento záznam sa týka C++23. Uvedená zdrojová stránka obsahuje priebežne sa vyvíjajúci pracovný návrh, nie definitívne vydanie C++23. Príznak kompilátora nie je dôkazom fungovania v produkčnom prostredí.

Príklady

#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';
}

Výsledok

1 2
1 2
3

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje