Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

tss_delete — eliminar uma chave de armazenamento específica de uma thread

tss_delete liberta os recursos de uma chave de armazenamento específica de uma thread, mas não invoca destrutores nem liberta automaticamente os dados apontados.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

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

tss_delete(key) de <threads.h> liberta os recursos do armazenamento específico de uma thread identificado por key. Devolve void. Utilize uma chave criada com sucesso por tss_create, antes de a thread que faz a chamada começar a executar destrutores.

A eliminação da chave não invoca quaisquer destrutores: a memória alocada com malloc tem de ser libertada separadamente. Coordene todas as threads para que deixem de utilizar a chave antes de a eliminar. Se outra thread estiver a executar destrutores, o efeito da eliminação sobre o número de chamadas ao destrutor desta chave nessa thread não está especificado.

O exemplo mantém o ponteiro, elimina a chave e liberta o objeto por si próprio. O contador mostra que o destrutor não foi chamado.

Exemplos

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

Resultado

destructor calls: 0

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes