Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C

mtx_destroy — oslobađanje resursa mutexa

mtx_destroy iz <threads.h> oslobađa resurse mutexa. Ne vraća nikakvu vrijednost; tijekom uništavanja nijedna dretva ne smije biti blokirana čekajući taj mutex.

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

Sintaksa

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

mtx_destroy(mtx_t *mtx) oslobađa resurse koje koristi navedeni mutex. Funkcija je deklarirana u <threads.h> i vraća void, a ne kod uspjeha.

Normativni uvjet glasi da nijedna dretva ne smije biti blokirana čekajući ovaj mutex. Siguran postupak čišćenja jest završiti njegovu upotrebu, ostaviti ga otključanim i zatim pozvati mtx_destroy. Nemojte smatrati uništavanje zamjenom za mtx_unlock.

Primjer uništava mutex samo nakon uspješnog poziva mtx_init. Ne stvara dodatne dretve pa nema dretvi koje čekaju.

Primjeri

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

Rezultat

Mutex destroyed.

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori