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

CKTIS / C

mtx_trylock — tenter de verrouiller un mutex sans attendre

mtx_trylock tente de verrouiller un mutex sans attendre qu’il soit libéré. Le résultat distingue la réussite, l’indisponibilité et l’erreur.

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

Syntaxe

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

mtx_trylock de <threads.h> prend un pointeur vers un mtx_t initialisé. Contrairement à mtx_lock, cette fonction n’attend pas qu’un mutex occupé devienne disponible.

Elle renvoie thrd_success, thrd_busy ou thrd_error. En C23, la tentative peut échouer de façon spurieuse : la fonction peut renvoyer thrd_busy même si le mutex n’est pas verrouillé.

Seule une réussite autorise les opérations protégées ; appelle ensuite mtx_unlock. Une acquisition réussie se synchronise avec les appels précédents à mtx_unlock sur ce mutex. Un échec n’assure pas cette synchronisation.

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;

    int result = mtx_trylock(&mutex);
    if (result == thrd_success) {
        /* Protected work belongs here. */
        if (mtx_unlock(&mutex) != thrd_success)
            return EXIT_FAILURE;
    } else if (result != thrd_busy) {
        mtx_destroy(&mutex);
        return EXIT_FAILURE;
    }

    mtx_destroy(&mutex);
    puts("done");
    return EXIT_SUCCESS;
}

Résultat

done

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