База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

tss_delete — изтриване на ключ за специфично за нишка хранилище

tss_delete освобождава ресурси на ключ за специфично за нишка хранилище, но не извиква деструктори и не освобождава автоматично данните, към които сочи ключът.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

#include <threads.h>
void tss_delete(tss_t key);

tss_delete(key) от <threads.h> освобождава ресурсите на специфичното за нишка хранилище, идентифицирано с key. Функцията връща void. Използвай ключ, успешно създаден с tss_create, преди извикващата нишка да започне да изпълнява деструктори.

Изтриването на ключа не извиква деструктори: паметта, заделена с malloc, трябва да се освободи отделно. Координирай всички нишки така, че да спрат да използват ключа, преди да го изтриеш. Ако друга нишка изпълнява деструктори, ефектът от изтриването върху броя извиквания на деструктора за този ключ в тази нишка не е специфициран.

Примерът запазва указателя, изтрива ключа и сам освобождава обекта. Броячът показва, че деструкторът не е извикан.

Примери

#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;
}

Резултат

destructor calls: 0

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници