CKTIS / C
mtx_trylock — pokušaj zaključavanja mutexa bez čekanja
mtx_trylock pokušava zauzeti mutex bez čekanja da se oslobodi. Rezultat razlikuje uspjeh, zauzetost i pogrešku.
Verzija: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <threads.h>
int mtx_trylock(mtx_t *mtx);mtx_trylock iz <threads.h> prima pokazivač na inicijalizirani mtx_t. Za razliku od mtx_lock, ne čeka da zauzeti mutex postane dostupan.
Vraća thrd_success, thrd_busy ili thrd_error. U C23 pokušaj može ne uspjeti čak i ako mutex nije zaključan: funkcija i tada može vratiti thrd_busy.
Samo uspjeh dopušta izvođenje zaštićenih operacija; zatim pozovi mtx_unlock. Uspješno zauzimanje sinkronizira se s prethodnim pozivima mtx_unlock na tom mutexu. Neuspjeh ne pruža takvu sinkronizaciju.
Primjeri
#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;
}Rezultat
done
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.