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.