Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

tss_get — leggere un puntatore specifico del thread

tss_get legge il puntatore memorizzato sotto una chiave di archiviazione specifica del thread per il thread chiamante.

Versione: C23; repository compiler flag, production runtime not attested

Sintassi

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

tss_get(key) di <threads.h> restituisce il void * associato al thread chiamante. La stessa chiave può contenere puntatori diversi in thread diversi.

Il valore iniziale è NULL; tss_set lo modifica. Anche un risultato nullo indica un errore, quindi non permette di distinguere un NULL memorizzato da un errore.

La chiave deve provenire da una chiamata riuscita a tss_create, eseguita prima che il thread inizi a eseguire distruttori. Non usarla dopo tss_delete. La lettura non copia l’oggetto puntato: gestiscine la durata. tss_delete non invoca il suo distruttore.

Esempi

#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;
}

Risultato

initial_null=1
value=42

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti