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

CKTIS / C

thread_local — um objeto separado para cada thread

thread_local atribui a um objeto uma duração de armazenamento associada ao thread. _Thread_local continua a ser uma grafia equivalente, mas obsolescente.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

thread_local int counter = 0;
static thread_local int private_counter = 0;
extern thread_local int external_counter;
/* At block scope: */
/* static thread_local int local_counter = 0; */
/* Obsolescent equivalent spelling: _Thread_local */

thread_local é uma palavra-chave de C23 que não requer nenhum cabeçalho. Cada thread tem um objeto separado, que existe durante toda a execução desse thread. _Thread_local é uma grafia equivalente, mas obsolescente.

No âmbito de bloco, também é necessário static ou extern; todas as declarações do mesmo objeto têm de manter thread_local. O especificador não pode ser usado para declarar funções. A inicialização ocorre no arranque do thread, não em cada chamada de função.

O acesso indireto a partir de outro thread tem comportamento definido pela implementação. O exemplo mostra a persistência entre chamadas, não o isolamento entre threads.

Exemplos

#include <stdio.h>

static int next(void)
{
    static thread_local int counter = 0;
    return ++counter;
}

int main(void)
{
    int first = next();
    int second = next();
    printf("%d %d\n", first, second);
    return 0;
}

Resultado

1 2

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