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

CKTIS / C

mtx_lock — verrouiller un mutex

mtx_lock attend de pouvoir acquérir un mutex. Elle renvoie thrd_success en cas de réussite ou thrd_error en cas d’échec.

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

Syntaxe

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

mtx_lock, déclarée dans <threads.h>, bloque l’exécution jusqu’à l’acquisition du mutex désigné par mtx. Initialisez-le d’abord correctement avec mtx_init. Après l’acquisition, exécutez la section critique, puis appelez mtx_unlock.

N’appelez pas de nouveau cette fonction pour un mutex non récursif déjà détenu par le thread appelant : cela constitue un comportement indéfini, et non une erreur garantie. Les déverrouillages antérieurs du même mutex se synchronisent avec son acquisition.

L’exemple utilise un seul thread pour montrer le cycle de vie du mutex, et non la contention entre threads. Le simple choix du mode C23 ne prouve pas que la bibliothèque d’exécution prend en charge les threads.

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;

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

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

Résultat

1

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