Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

mtx_destroy — zwalnianie zasobów muteksu

mtx_destroy z <threads.h> zwalnia zasoby muteksu. Nie zwraca wartości; podczas niszczenia żaden wątek nie może oczekiwać na ten muteks.

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

Składnia

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

mtx_destroy(mtx_t *mtx) zwalnia zasoby używane przez wskazany muteks. Funkcja jest zadeklarowana w <threads.h> i zwraca void, nie kod powodzenia.

Warunek normatywny: żaden wątek nie może być zablokowany w oczekiwaniu na ten muteks. Bezpieczny schemat sprzątania: zakończ jego używanie, pozostaw go odblokowanego i dopiero wywołaj mtx_destroy. Nie traktuj niszczenia jako zamiennika mtx_unlock.

Przykład niszczy muteks tylko po udanym mtx_init. Nie tworzy dodatkowych wątków, więc nie ma oczekujących.

Przykłady

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

Wynik

Mutex destroyed.

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła