CKTIS / C++
thread_local — una variable independiente para cada hilo
La palabra clave thread_local asigna a una variable una duración de almacenamiento de hilo: cada hilo tiene su propia instancia, que se conserva entre llamadas a funciones. No crea una variable compartida protegida frente al acceso concurrente.
Versión: C++23; repository compiler flag, production runtime not attested
Sintaxis
thread_local T name = initializer;
static thread_local T name = initializer;
extern thread_local T name;thread_local asigna a una variable una duración de almacenamiento de hilo. Cada hilo tiene una instancia distinta, y el uso del nombre hace referencia a la instancia del hilo actual. Una variable local de este tipo conserva su valor entre llamadas a funciones dentro del mismo hilo. Una variable automática ordinaria no lo hace, mientras que una variable local static sin thread_local se comparte entre llamadas realizadas desde distintos hilos.
En C++23, el especificador puede usarse en variables de ámbito de espacio de nombres, variables de ámbito de bloque y miembros de datos estáticos de una clase, pero no en parámetros de función ni en miembros de datos no estáticos. Puede combinarse con static o extern; esto no cambia su duración de almacenamiento de hilo. Todas las declaraciones de la misma variable deben incluir thread_local.
La inicialización dinámica de una variable local thread_local tiene lugar la primera vez que el flujo de control pasa por su declaración en ese hilo. No generalices esta regla a la inicialización de todas las variables de ámbito de espacio de nombres. Un objeto construido se destruye cuando su hilo termina normalmente, no cuando retorna la función. No uses un puntero ni una referencia a él una vez finalizada su vida útil.
thread_local no es ni un bloqueo ni una operación atómica. Compartir con otro hilo un puntero a una instancia concreta no crea una copia nueva ni proporciona sincronización. En el ejemplo, cada hilo incrementa su propio count; join() garantiza que el hilo de trabajo termine antes de leer sus resultados, por lo que la salida esperada es determinista.
Esta entrada corresponde a C++23. El sitio fuente indicado aloja un borrador de trabajo en evolución, no una publicación definitiva de C++23. Una opción del compilador no demuestra que funcione en un entorno de producción.
Ejemplos
#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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.