Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

tss_create — creare una chiave per l’archiviazione specifica del thread

tss_create crea una chiave che consente a ogni thread di conservare un proprio valore puntatore. Controlla il risultato prima di usare la chiave e pianifica come liberare le risorse.

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

Sintassi

#include <threads.h>
int tss_create(tss_t *key, tss_dtor_t dtor);

tss_create di <threads.h> scrive una chiave nell’oggetto tss_t indicato da key. Una chiave identifica un valore puntatore distinto per ogni thread; inizialmente tale valore è nullo, anche nei thread appena creati.

In caso di successo restituisce thrd_success. Con thrd_error, la rappresentazione della chiave è indeterminata: non usarla e non passarla a tss_delete.

dtor può essere NULL. tss_delete non invoca il distruttore e neppure la terminazione del programma invoca i distruttori TSS. Non chiamare tss_create da un distruttore.

L’esempio usa tss_set e tss_get nel thread corrente; non crea thread nuovi. L’oggetto puntato rimane valido finché la chiave non viene eliminata. Un’opzione del compilatore per C23 non dimostra la disponibilità della libreria dei thread né attesta il comportamento dell’ambiente di esecuzione in produzione.

Esempi

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

Risultato

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