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.