CKTIS / C
mtx_destroy — libérer les ressources d’un mutex
mtx_destroy de <threads.h> libère les ressources d’un mutex. La fonction ne renvoie aucune valeur ; aucun thread ne doit être bloqué en attente de ce mutex lors de sa destruction.
Version : C23; repository compiler flag, production runtime not attested
Syntaxe
#include <threads.h>
void mtx_destroy(mtx_t *mtx);mtx_destroy(mtx_t *mtx) libère les ressources utilisées par le mutex désigné. La fonction est déclarée dans <threads.h> et renvoie void, et non un code de réussite.
La condition normative est qu’aucun thread ne doit être bloqué en attente de ce mutex. Une méthode sûre de nettoyage consiste à terminer son utilisation, à le laisser déverrouillé, puis à appeler mtx_destroy. Ne considérez pas sa destruction comme un substitut à mtx_unlock.
L’exemple détruit le mutex uniquement après la réussite de mtx_init. Il ne crée aucun thread supplémentaire ; il n’y a donc aucun thread en attente.
Exemples
#include <stdio.h>
#include <stdlib.h>
#include <threads.h>
int main(void)
{
mtx_t mutex;
if (mtx_init(&mutex, mtx_plain) != thrd_success) {
return EXIT_FAILURE;
}
mtx_destroy(&mutex);
puts("Mutex destroyed.");
return EXIT_SUCCESS;
}
Résultat
Mutex destroyed.
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.