CKTIS / C
mtx_init — initialiser un mutex
mtx_init de <threads.h> initialise un mutex avec les propriétés choisies. Vérifiez le résultat avant d’utiliser l’objet et terminez son cycle de vie avec mtx_destroy.
Version : C23; repository compiler flag, production runtime not attested
Syntaxe
#include <threads.h>
int mtx_init(mtx_t *mtx, int type);mtx_init enregistre l’identifiant d’un nouveau mutex dans l’objet mtx_t pointé par mtx. La fonction renvoie thrd_success ou thrd_error. En cas d’échec, n’utilisez pas l’objet comme un mutex initialisé.
type doit être l’une de ces quatre valeurs : mtx_plain, mtx_timed, mtx_plain | mtx_recursive, mtx_timed | mtx_recursive. Les deux premières désignent des mutex non récursifs ; mtx_recursive permet au même thread de verrouiller le mutex plusieurs fois, et mtx_timed prend en charge les délais d’attente.
Initialisez le mutex avant de le partager avec d’autres threads. Ne réinitialisez pas un mutex actif. Après utilisation, appelez mtx_destroy ; aucun thread ne doit alors attendre ce mutex.
La prise en charge de <threads.h> est facultative ; une valeur de 1 pour __STDC_NO_THREADS__ indique son absence. L’option C23 du dépôt ne garantit pas la disponibilité de la bibliothèque d’exécution en production.
Exemples
#include <stdio.h>
#include <stdlib.h>
#if defined(__STDC_NO_THREADS__) && __STDC_NO_THREADS__ == 1
#error "Threads support required"
#else
#include <threads.h>
int main(void)
{
mtx_t mutex;
if (mtx_init(&mutex, mtx_plain) != thrd_success) {
fputs("mtx_init failed\n", stderr);
return EXIT_FAILURE;
}
mtx_destroy(&mutex);
puts("OK");
return EXIT_SUCCESS;
}
#endif
Résultat
OK
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.