Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

mtx_lock — blokowanie muteksu

mtx_lock czeka na przejęcie muteksu. Zwraca thrd_success po sukcesie albo thrd_error przy błędzie.

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

Składnia

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

mtx_lock z <threads.h> blokuje wykonanie do przejęcia muteksu wskazywanego przez mtx. Wcześniej poprawnie zainicjalizuj go przez mtx_init. Po sukcesie wykonaj sekcję krytyczną, a następnie wywołaj mtx_unlock.

Nie wywołuj tej funkcji ponownie dla nierekurencyjnego muteksu już posiadanego przez ten sam wątek: to niezdefiniowane zachowanie, nie gwarantowany błąd. Wcześniejsze odblokowania tego samego muteksu synchronizują się z jego przejęciem.

Przykład używa jednego wątku i pokazuje cykl życia muteksu, nie rywalizację wątków. Sam wybór trybu C23 nie potwierdza dostępności obsługi wątków w bibliotece wykonawczej.

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;

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

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

Wynik

1

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

Źródła