Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources