Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

thread_local — samostatná proměnná pro každé vlákno

Klíčové slovo thread_local dává proměnné dobu trvání úložiště vlákna: každé vlákno má vlastní instanci, která se zachovává mezi voláními funkcí. Nevytváří jednu sdílenou proměnnou chráněnou před souběžným přístupem.

Verze: 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 dává proměnné dobu trvání úložiště vlákna. Každé vlákno má samostatnou instanci a použití názvu odkazuje na instanci aktuálního vlákna. Lokální proměnná tohoto druhu si zachovává hodnotu mezi voláními funkcí v témže vlákně. Běžná automatická proměnná to nedělá, zatímco lokální proměnná static bez thread_local je sdílena voláními z různých vláken.

V C++23 lze tento specifikátor použít pro proměnné na úrovni jmenného prostoru, proměnné na úrovni bloku a statické datové členy třídy, nikoli však pro parametry funkcí nebo nestatické datové členy. Lze jej kombinovat s static nebo extern; tím se doba trvání úložiště vlákna nemění. Každá deklarace téže proměnné musí obsahovat thread_local.

Dynamická inicializace lokální proměnné thread_local nastane poprvé, když řízení v daném vlákně projde její deklarací. Nevztahujte toto pravidlo automaticky na inicializaci všech proměnných na úrovni jmenného prostoru. Vytvořený objekt se zničí při normálním ukončení svého vlákna, nikoli při návratu z funkce. Po skončení jeho životnosti nepoužívejte ukazatel ani referenci na něj.

thread_local není zámek ani atomická operace. Sdílení ukazatele na konkrétní instanci s jiným vláknem nevytvoří novou kopii ani nezajistí synchronizaci. V příkladu každé vlákno zvyšuje vlastní count; join() zajistí, že pracovní vlákno skončí před přečtením výsledků, takže očekávaný výstup je deterministický.

Tento záznam se vztahuje k C++23. Uvedený zdrojový web obsahuje průběžně se vyvíjející pracovní návrh, nikoli definitivní vydání C++23. Příznak kompilátoru není důkazem fungování v produkčním prostředí.

Pří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ýsledek

1 2
1 2
3

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje