KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

mtx_trylock — proberen een mutex te vergrendelen zonder te wachten

mtx_trylock probeert een mutex te vergrendelen zonder te wachten tot deze wordt vrijgegeven. Het resultaat maakt onderscheid tussen succes, bezet en een fout.

Versie: C23; repository compiler flag, production runtime not attested

Syntax

#include <threads.h>
int mtx_trylock(mtx_t *mtx);

mtx_trylock uit <threads.h> ontvangt een pointer naar een geïnitialiseerde mtx_t. Anders dan mtx_lock wacht de functie niet tot een bezette mutex beschikbaar wordt.

De functie retourneert thrd_success, thrd_busy of thrd_error. In C23 kan de poging ook mislukken als de mutex niet vergrendeld is; de functie kan dan toch thrd_busy retourneren.

Alleen bij succes zijn beschermde bewerkingen toegestaan; roep daarna mtx_unlock aan. Een geslaagde verkrijging synchroniseert met eerdere aanroepen van mtx_unlock op die mutex. Mislukking biedt die synchronisatie niet.

Voorbeelden

#include <stdio.h>
#include <stdlib.h>
#include <threads.h>

int main(void)
{
    mtx_t mutex;
    if (mtx_init(&mutex, mtx_plain) != thrd_success)
        return EXIT_FAILURE;

    int result = mtx_trylock(&mutex);
    if (result == thrd_success) {
        /* Protected work belongs here. */
        if (mtx_unlock(&mutex) != thrd_success)
            return EXIT_FAILURE;
    } else if (result != thrd_busy) {
        mtx_destroy(&mutex);
        return EXIT_FAILURE;
    }

    mtx_destroy(&mutex);
    puts("done");
    return EXIT_SUCCESS;
}

Resultaat

done

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