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.