KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

mtx_destroy — mutexbronnen vrijgeven

mtx_destroy uit <threads.h> geeft de bronnen van een mutex vrij. De functie retourneert geen waarde; tijdens het vernietigen mag geen thread geblokkeerd op die mutex wachten.

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

Syntax

#include <threads.h>
void mtx_destroy(mtx_t *mtx);

mtx_destroy(mtx_t *mtx) geeft de bronnen vrij die door de aangewezen mutex worden gebruikt. De functie is gedeclareerd in <threads.h> en retourneert void, geen succescode.

De normatieve voorwaarde is dat geen enkele thread geblokkeerd op deze mutex mag wachten. Een veilige manier om op te ruimen is het gebruik ervan te beëindigen, de mutex ontgrendeld te laten en vervolgens mtx_destroy aan te roepen. Beschouw vernietigen niet als vervanging voor mtx_unlock.

Het voorbeeld vernietigt de mutex alleen nadat mtx_init is geslaagd. Het maakt geen extra threads aan, dus er zijn geen threads die wachten.

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;
    }

    mtx_destroy(&mutex);
    puts("Mutex destroyed.");
    return EXIT_SUCCESS;
}

Resultaat

Mutex destroyed.

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