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

CKTIS / C

mtx_unlock — déverrouiller un mutex

mtx_unlock de <threads.h> déverrouille un mutex appartenant au thread appelant et renvoie un code de réussite ou d’erreur.

Version : C23; repository compiler flag, production runtime not attested

Syntaxe

#include <threads.h>
int mtx_unlock(mtx_t *mtx);

mtx_unlock(mtx) déverrouille le mutex pointé par mtx. L’argument doit pointer vers un mutex initialisé, toujours existant et verrouillé par le thread appelant. Déverrouiller un mutex qui n’est pas verrouillé ou qui appartient à un autre thread entraîne un comportement indéfini.

La fonction renvoie thrd_success en cas de réussite, ou thrd_error si la demande ne peut pas être satisfaite. Un code d’erreur ne dispense pas de respecter les conditions d’appel. Le déverrouillage se synchronise avec une acquisition ultérieure du même mutex, ce qui rend visibles les écritures protégées.

L’exemple utilise un seul thread : il initialise le mutex, le verrouille, définit value, le déverrouille, puis le détruit. Il illustre le cycle de vie, et non une compétition entre threads. Choisir le mode C23 ne garantit pas à lui seul que la bibliothèque de threads soit disponible à l’exécution.

Exemples

#include <stdio.h>
#include <stdlib.h>
#include <threads.h>

int main(void)
{
    mtx_t mutex;
    int value = 0;

    if (mtx_init(&mutex, mtx_plain) != thrd_success)
        return EXIT_FAILURE;

    if (mtx_lock(&mutex) != thrd_success) {
        mtx_destroy(&mutex);
        return EXIT_FAILURE;
    }

    value = 42;

    if (mtx_unlock(&mutex) != thrd_success)
        abort();

    mtx_destroy(&mutex);
    printf("%d\n", value);
    return EXIT_SUCCESS;
}

Résultat

42

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