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

CKTIS / C

tss_get — ler um ponteiro específico da thread

tss_get lê o ponteiro guardado sob uma chave de armazenamento específico da thread para a thread que efetua a chamada.

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

Sintaxe

#include <threads.h>
void *tss_get(tss_t key);

tss_get(key) de <threads.h> devolve o void * associado à thread que efetua a chamada. A mesma chave pode conter ponteiros diferentes em threads diferentes.

O valor inicial é NULL; tss_set altera-o. Um resultado nulo também indica uma falha, pelo que não permite distinguir um NULL guardado de uma falha.

A chave tem de provir de uma chamada bem-sucedida a tss_create, executada antes de a thread começar a executar destrutores. Não a utilize depois de tss_delete. A leitura não copia o objeto apontado: controle a sua duração. tss_delete não invoca o respetivo destrutor.

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;

    printf("initial_null=%d\n", tss_get(key) == NULL);

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

    int *p = tss_get(key);
    if (p != &value) {
        tss_delete(key);
        return EXIT_FAILURE;
    }
    printf("value=%d\n", *p);

    tss_delete(key);
    return EXIT_SUCCESS;
}

Resultado

initial_null=1
value=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