Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła