Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

thread_local — uma variável própria para cada thread

A palavra-chave thread_local atribui a uma variável uma duração de armazenamento por thread: cada thread tem a sua própria instância, que se mantém entre chamadas de funções. Não cria uma única variável partilhada e protegida contra acessos concorrentes.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

thread_local T name = initializer;
static thread_local T name = initializer;
extern thread_local T name;

thread_local atribui a uma variável uma duração de armazenamento por thread. Cada thread tem uma instância distinta, e a utilização do nome refere-se à instância do thread atual. Uma variável local deste tipo mantém o seu valor entre chamadas de funções no mesmo thread. Uma variável automática normal não o faz, enquanto uma variável local static sem thread_local é partilhada por chamadas provenientes de threads diferentes.

Em C++23, o especificador pode ser usado em variáveis com âmbito de namespace, variáveis com âmbito de bloco e membros de dados estáticos de uma classe, mas não em parâmetros de funções nem em membros de dados não estáticos. Pode ser combinado com static ou extern; isso não altera a duração de armazenamento por thread. Todas as declarações da mesma variável têm de incluir thread_local.

A inicialização dinâmica de uma variável local thread_local ocorre na primeira vez que o fluxo de controlo passa pela sua declaração nesse thread. Não generalize esta regra à inicialização de todas as variáveis com âmbito de namespace. Um objeto construído é destruído quando o seu thread termina normalmente, não quando a função retorna. Não utilize um ponteiro nem uma referência para esse objeto depois de a sua duração de vida terminar.

thread_local não é um bloqueio nem uma operação atómica. Partilhar com outro thread um ponteiro para uma instância específica não cria uma nova cópia nem fornece sincronização. No exemplo, cada thread incrementa o seu próprio count; join() garante que o thread de trabalho termina antes de os resultados serem lidos, tornando determinístico o resultado esperado.

Esta entrada diz respeito a C++23. O site de origem indicado contém um projeto de trabalho em evolução, e não uma publicação definitiva de C++23. Uma opção do compilador não comprova o funcionamento num ambiente de produção.

Exemplos

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

Resultado

1 2
1 2
3

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes