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.