Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

tss_delete — eliminare una chiave di archiviazione specifica del thread

tss_delete rilascia le risorse di una chiave di archiviazione specifica del thread, ma non chiama i distruttori né libera automaticamente i dati a cui punta.

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

Sintassi

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

tss_delete(key) di <threads.h> rilascia le risorse dell’archiviazione specifica del thread identificata da key. Restituisce void. Usa una chiave creata correttamente con tss_create, prima che il thread chiamante inizi a eseguire i distruttori.

L’eliminazione della chiave non chiama alcun distruttore: la memoria allocata con malloc deve essere liberata separatamente. Coordina tutti i thread affinché smettano di usare la chiave prima di eliminarla. Se un altro thread sta eseguendo i distruttori, l’effetto dell’eliminazione sul numero di chiamate al distruttore di questa chiave in quel thread non è specificato.

L’esempio conserva il puntatore, elimina la chiave e libera l’oggetto autonomamente. Il contatore mostra che il distruttore non è stato chiamato.

Esempi

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

static int destructor_calls;

static void destroy(void *ptr)
{
    ++destructor_calls;
    free(ptr);
}

int main(void)
{
    tss_t key;
    if (tss_create(&key, destroy) != thrd_success) {
        return EXIT_FAILURE;
    }

    int *value = malloc(sizeof *value);
    if (value == NULL) {
        tss_delete(key);
        return EXIT_FAILURE;
    }
    *value = 42;

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

    tss_delete(key);
    printf("destructor calls: %d\n", destructor_calls);
    free(value);
    return EXIT_SUCCESS;
}

Risultato

destructor calls: 0

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