CKTIS / C
tss_delete — odstranění klíče úložiště specifického pro vlákno
tss_delete uvolní prostředky klíče úložiště specifického pro vlákno, ale nevolá destruktory ani automaticky neuvolňuje data, na která klíč ukazuje.
Verze: C23; repository compiler flag, production runtime not attested
Syntaxe
#include <threads.h>
void tss_delete(tss_t key);tss_delete(key) z <threads.h> uvolní prostředky úložiště specifického pro vlákno, které je určeno pomocí key. Vrací void. Použij klíč úspěšně vytvořený funkcí tss_create ještě předtím, než volající vlákno začne vykonávat destruktory.
Odstranění klíče žádné destruktory nevolá: paměť alokovanou pomocí malloc je nutné uvolnit zvlášť. Zajisti, aby všechna vlákna přestala klíč používat ještě před jeho odstraněním. Pokud jiné vlákno vykonává destruktory, vliv odstranění na počet volání destruktoru tohoto klíče v daném vlákně není specifikován.
Příklad zachová ukazatel, odstraní klíč a objekt uvolní samostatně. Počítadlo ukazuje, že destruktor nebyl zavolán.
Pří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ýsledek
destructor calls: 0
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.