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

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.

Sources