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

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.

Fontes