CKTIS / C
tss_delete — odstránenie kľúča úložiska špecifického pre vlákno
tss_delete uvoľní prostriedky kľúča úložiska špecifického pre vlákno, ale nevolá deštruktory ani automaticky neuvoľňuje údaje, na ktoré kľúč ukazuje.
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <threads.h>
void tss_delete(tss_t key);tss_delete(key) z <threads.h> uvoľní prostriedky úložiska špecifického pre vlákno, ktoré identifikuje key. Vráti void. Použi kľúč úspešne vytvorený funkciou tss_create ešte predtým, ako volajúce vlákno začne vykonávať deštruktory.
Odstránenie kľúča nevolá žiadne deštruktory: pamäť alokovanú pomocou malloc treba uvoľniť samostatne. Zabezpeč, aby všetky vlákna prestali kľúč používať ešte pred jeho odstránením. Ak iné vlákno vykonáva deštruktory, vplyv odstránenia na počet volaní deštruktora tohto kľúča v danom vlákne nie je špecifikovaný.
Príklad zachová ukazovateľ, odstráni kľúč a objekt uvoľní samostatne. Počítadlo ukazuje, že deštruktor nebol zavolaný.
Príklady
#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;
}Výsledok
destructor calls: 0
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.