KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

mtx_init — een mutex initialiseren

mtx_init uit <threads.h> initialiseert een mutex met geselecteerde eigenschappen. Controleer het resultaat voordat je het object gebruikt en beëindig de levenscyclus met mtx_destroy.

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

Syntax

#include <threads.h>
int mtx_init(mtx_t *mtx, int type);

mtx_init slaat de identificatie van een nieuwe mutex op in het mtx_t-object waarnaar mtx verwijst. De functie retourneert thrd_success of thrd_error. Gebruik het object na een fout niet als een geïnitialiseerde mutex.

type moet een van deze vier waarden zijn: mtx_plain, mtx_timed, mtx_plain | mtx_recursive, mtx_timed | mtx_recursive. De eerste twee staan voor niet-recursieve mutexen; mtx_recursive staat hetzelfde thread toe de mutex herhaaldelijk te vergrendelen, en mtx_timed ondersteunt tijdslimieten.

Initialiseer de mutex voordat je die met andere threads deelt. Initialiseer een actieve mutex niet opnieuw. Roep na gebruik mtx_destroy aan; op dat moment mag geen enkele thread op die mutex wachten.

Ondersteuning voor <threads.h> is optioneel; als __STDC_NO_THREADS__ gelijk is aan 1, ontbreekt die ondersteuning. De C23-vlag van de repository bevestigt niet dat de runtimebibliotheek in productie beschikbaar is.

Voorbeelden

#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

Resultaat

OK

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