CKTIS / C
mtx_lock — een mutex vergrendelen
mtx_lock wacht totdat een mutex is verkregen. De functie retourneert thrd_success bij succes en thrd_error bij een fout.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <threads.h>
int mtx_lock(mtx_t *mtx);mtx_lock uit <threads.h> blokkeert de uitvoering totdat de mutex waarnaar mtx verwijst, is verkregen. Initialiseer de mutex eerst met succes met mtx_init. Voer na het verkrijgen ervan de kritieke sectie uit en roep daarna mtx_unlock aan.
Roep deze functie niet opnieuw aan voor een niet-recursieve mutex die al in bezit is van de aanroepende thread: dat is ongedefinieerd gedrag, geen gegarandeerde fout. Eerdere ontgrendelingen van dezelfde mutex synchroniseren met het verkrijgen ervan.
Het voorbeeld gebruikt één thread om de levenscyclus van de mutex te laten zien, niet de strijd tussen threads om de mutex. Alleen de C23-modus selecteren toont niet aan dat de runtimebibliotheek threadondersteuning biedt.
Voorbeelden
#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;
}Resultaat
1
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.