Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

mtx_trylock — próba zablokowania muteksu bez oczekiwania

mtx_trylock próbuje zablokować muteks bez oczekiwania na jego zwolnienie. Wynik rozróżnia sukces, zajętość i błąd.

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

Składnia

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

mtx_trylock z <threads.h> przyjmuje wskaźnik do zainicjalizowanego mtx_t. W przeciwieństwie do mtx_lock nie czeka na zwolnienie zajętego muteksu.

Zwraca thrd_success, thrd_busy albo thrd_error. W C23 próba może się nie powieść nawet wtedy, gdy muteks jest wolny: funkcja może zwrócić thrd_busy, mimo że muteks nie jest zablokowany.

Tylko sukces pozwala wykonać chronione operacje; potem wywołaj mtx_unlock. Udane przejęcie synchronizuje się z wcześniejszymi wywołaniami mtx_unlock tego muteksu. Porażka nie zapewnia takiej synchronizacji.

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;

    int result = mtx_trylock(&mutex);
    if (result == thrd_success) {
        /* Protected work belongs here. */
        if (mtx_unlock(&mutex) != thrd_success)
            return EXIT_FAILURE;
    } else if (result != thrd_busy) {
        mtx_destroy(&mutex);
        return EXIT_FAILURE;
    }

    mtx_destroy(&mutex);
    puts("done");
    return EXIT_SUCCESS;
}

Wynik

done

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

Źródła