KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen