CKTIS / C
tss_delete — usuwanie klucza pamięci specyficznej dla wątku
tss_delete zwalnia zasoby klucza pamięci specyficznej dla wątku, ale nie wywołuje destruktorów ani nie zwalnia automatycznie wskazywanych danych.
Wersja: C23; repository compiler flag, production runtime not attested
Składnia
#include <threads.h>
void tss_delete(tss_t key);tss_delete(key) z <threads.h> zwalnia zasoby pamięci specyficznej dla wątku identyfikowanej przez key. Zwraca void. Używaj klucza utworzonego pomyślnie przez tss_create, przed rozpoczęciem wykonywania destruktorów przez wywołujący wątek.
Usunięcie klucza nie wywołuje destruktorów: pamięć przydzielona przez malloc wymaga osobnego zwolnienia. Uzgodnij zakończenie korzystania z klucza przez wszystkie wątki przed jego usunięciem. Jeśli inny wątek wykonuje destruktory, wpływ usunięcia na liczbę wywołań destruktora tego klucza w tamtym wątku jest nieokreślony.
Przykład zachowuje wskaźnik, usuwa klucz i sam zwalnia obiekt. Licznik pokazuje brak wywołania destruktora.
Przykłady
#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;
}Wynik
destructor calls: 0
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.