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.