CKTIS / C
tss_create — criar uma chave de armazenamento específica de uma thread
tss_create cria uma chave que permite a cada thread guardar um valor de ponteiro próprio. Verifique o resultado antes de utilizar a chave e planeie a libertação dos recursos.
Versão: C23; repository compiler flag, production runtime not attested
Sintaxe
#include <threads.h>
int tss_create(tss_t *key, tss_dtor_t dtor);tss_create, de <threads.h>, escreve uma chave no objeto tss_t indicado por key. Uma chave identifica um valor de ponteiro distinto para cada thread; inicialmente, esse valor é nulo, incluindo nas threads criadas recentemente.
Em caso de sucesso, devolve thrd_success. Com thrd_error, a representação da chave é indeterminada: não a utilize nem a passe a tss_delete.
dtor pode ser NULL. tss_delete não invoca o destrutor, e o fim do programa também não invoca destrutores TSS. Não chame tss_create a partir de um destrutor.
O exemplo utiliza tss_set e tss_get na thread atual; não cria uma thread nova. O objeto apontado permanece válido até a chave ser eliminada. Uma opção de compilação C23 não comprova a disponibilidade da biblioteca de threads nem atesta o comportamento do ambiente de execução em produção.
Exemplos
#include <stdio.h>
#include <threads.h>
int main(void)
{
tss_t key;
int value = 42;
if (tss_create(&key, NULL) != thrd_success)
return 1;
if (tss_get(key) != NULL) {
tss_delete(key);
return 2;
}
if (tss_set(key, &value) != thrd_success) {
tss_delete(key);
return 3;
}
int *stored = tss_get(key);
if (stored == NULL) {
tss_delete(key);
return 4;
}
printf("%d\n", *stored);
tss_delete(key);
return 0;
}Resultado
42
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.