CKTIS / C
mtx_unlock — een mutex ontgrendelen
mtx_unlock uit <threads.h> ontgrendelt een mutex die eigendom is van de aanroepende thread en retourneert een succes- of foutcode.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <threads.h>
int mtx_unlock(mtx_t *mtx);mtx_unlock(mtx) ontgrendelt de mutex waarnaar mtx wijst. Het argument moet verwijzen naar een geïnitialiseerde, nog bestaande mutex die door de aanroepende thread is vergrendeld. Het ontgrendelen van een niet-vergrendelde mutex of een mutex van een andere thread leidt tot ongedefinieerd gedrag.
Bij succes retourneert de functie thrd_success; als het verzoek niet kan worden ingewilligd, retourneert ze thrd_error. Een foutcode vervangt het naleven van de aanroepvoorwaarden niet. Het ontgrendelen synchroniseert met een latere vergrendeling van dezelfde mutex, waardoor beschermde schrijfbewerkingen zichtbaar worden.
Het voorbeeld gebruikt één thread: het initialiseert de mutex, vergrendelt deze, stelt value in, ontgrendelt de mutex en vernietigt deze. Het laat de levenscyclus zien, niet de concurrentiestrijd tussen threads. Alleen de C23-modus kiezen garandeert niet dat de threadbibliotheek tijdens runtime beschikbaar is.
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 = 42;
if (mtx_unlock(&mutex) != thrd_success)
abort();
mtx_destroy(&mutex);
printf("%d\n", value);
return EXIT_SUCCESS;
}Resultaat
42
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.