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

CKTIS / C

tss_set — definir um apontador específico da thread

tss_set armazena um apontador sob uma chave de armazenamento específica da thread atual e devolve o estado da operação.

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

Sintaxe

#include <threads.h>
int tss_set(tss_t key, void *val);

tss_set(key, val) de <threads.h> altera o valor apenas para a thread atual. Armazena um apontador, não uma cópia do objeto apontado; esse objeto tem de permanecer disponível enquanto o apontador for utilizado.

Utilize uma chave válida criada por uma chamada bem-sucedida a tss_create, antes de a thread começar a executar destrutores. O resultado é thrd_success ou thrd_error. NULL é um valor que pode ser armazenado.

A substituição de um valor não invoca o respetivo destrutor. Faça a gestão dos recursos separadamente. tss_delete também não invoca destrutores.

O exemplo utiliza apenas a thread principal; a variável local existe durante tempo suficiente. O modo de compilação C23 não atesta a disponibilidade da biblioteca de threads nem o comportamento de um ambiente de execução em produção.

Exemplos

#include <stdio.h>
#include <stdlib.h>
#include <threads.h>

int main(void)
{
    tss_t key;
    int value = 42;

    if (tss_create(&key, NULL) != thrd_success)
        return EXIT_FAILURE;

    if (tss_set(key, &value) != thrd_success) {
        tss_delete(key);
        return EXIT_FAILURE;
    }

    int *stored = tss_get(key);
    if (stored != &value) {
        tss_delete(key);
        return EXIT_FAILURE;
    }

    printf("%d\n", *stored);
    tss_delete(key);
    return EXIT_SUCCESS;
}

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