CKTIS / C
tss_delete — supprimer une clé de stockage spécifique à un thread
tss_delete libère les ressources associées à une clé de stockage spécifique à un thread, mais n’appelle pas les destructeurs et ne libère pas automatiquement les données pointées.
Version : C23; repository compiler flag, production runtime not attested
Syntaxe
#include <threads.h>
void tss_delete(tss_t key);tss_delete(key) de <threads.h> libère les ressources du stockage spécifique à un thread identifié par key. La fonction renvoie void. Utilisez une clé créée avec succès par tss_create, avant que le thread appelant ne commence à exécuter des destructeurs.
La suppression de la clé n’appelle aucun destructeur : la mémoire allouée avec malloc doit être libérée séparément. Coordonnez-vous avec tous les threads afin qu’ils cessent d’utiliser la clé avant de la supprimer. Si un autre thread exécute des destructeurs, l’effet de la suppression sur le nombre d’appels du destructeur associé à cette clé dans ce thread n’est pas spécifié.
L’exemple conserve le pointeur, supprime la clé et libère lui-même l’objet. Le compteur montre que le destructeur n’a pas été appelé.
Exemples
#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;
}Résultat
destructor calls: 0
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.