Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

mtx_unlock — odblokowanie muteksu

mtx_unlock z <threads.h> odblokowuje muteks należący do bieżącego wątku i zwraca kod powodzenia albo błędu.

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

Składnia

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

mtx_unlock(mtx) odblokowuje muteks wskazywany przez mtx. Argument musi wskazywać zainicjalizowany, nadal istniejący muteks zablokowany przez wywołujący wątek. Odblokowanie niezablokowanego muteksu lub muteksu należącego do innego wątku powoduje niezdefiniowane zachowanie.

Wynikiem jest thrd_success przy powodzeniu albo thrd_error, gdy żądanie nie może zostać spełnione. Kod błędu nie zastępuje przestrzegania warunków wywołania. Odblokowanie synchronizuje się z późniejszym przejęciem tego samego muteksu, zapewniając widoczność chronionych zapisów.

Przykład używa jednego wątku: inicjalizuje muteks, blokuje go, ustawia value, odblokowuje i niszczy muteks. Pokazuje cykl życia, nie współbieżną rywalizację. Sam wybór trybu C23 nie potwierdza dostępności biblioteki wątków w środowisku uruchomieniowym.

Przykłady

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

int main(void)
{
    mtx_t mutex;
    int value = 0;

    if (mtx_init(&mutex, mtx_plain) != thrd_success)
        return EXIT_FAILURE;

    if (mtx_lock(&mutex) != thrd_success) {
        mtx_destroy(&mutex);
        return EXIT_FAILURE;
    }

    value = 42;

    if (mtx_unlock(&mutex) != thrd_success)
        abort();

    mtx_destroy(&mutex);
    printf("%d\n", value);
    return EXIT_SUCCESS;
}

Wynik

42

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

Źródła