CKTIS / C
tss_delete — eliminar una clave de almacenamiento específica de un hilo
tss_delete libera los recursos de una clave de almacenamiento específica de un hilo, pero no invoca destructores ni libera automáticamente los datos apuntados.
Versión: C23; repository compiler flag, production runtime not attested
Sintaxis
#include <threads.h>
void tss_delete(tss_t key);tss_delete(key) de <threads.h> libera los recursos del almacenamiento específico de un hilo identificado por key. Devuelve void. Usa una clave creada correctamente con tss_create, antes de que el hilo que realiza la llamada empiece a ejecutar destructores.
Eliminar la clave no invoca ningún destructor: la memoria asignada con malloc debe liberarse por separado. Coordina con todos los hilos para que dejen de usar la clave antes de eliminarla. Si otro hilo está ejecutando destructores, no está especificado el efecto de la eliminación sobre el número de llamadas al destructor de esta clave en ese hilo.
El ejemplo conserva el puntero, elimina la clave y libera el objeto por su cuenta. El contador muestra que no se llamó al destructor.
Ejemplos
#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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.