CKTIS / C
mtx_timedlock — blokowanie muteksu z terminem
`mtx_timedlock` próbuje zablokować muteks do bezwzględnego terminu opartego na `TIME_UTC`. Rozróżnia uzyskanie blokady, przekroczenie terminu i błąd.
Wersja: C23; repository compiler flag, production runtime not attested
Składnia
#include <threads.h>
int mtx_timedlock(mtx_t *restrict mtx, const struct timespec *restrict ts);mtx_timedlock z <threads.h> oczekuje na blokadę lub upływ terminu ts: to czas bezwzględny TIME_UTC, nie okres oczekiwania ani czas monotoniczny. Termin nie gwarantuje dokładnej chwili powrotu.
Utwórz muteks przez mtx_init z mtx_timed albo mtx_timed | mtx_recursive; samo mtx_plain nie wystarcza. Wyniki to thrd_success, thrd_timedout i thrd_error. Tylko po sukcesie zwalniaj uzyskaną blokadę przez mtx_unlock.
Przykład używa niezablokowanego muteksu i wyznacza termin na jedną sekundę po odczytanym czasie TIME_UTC. Nie wymusza rywalizacji między wątkami. Obsługa środowiska wykonawczego nie została potwierdzona.
Przykłady
#include <stdio.h>
#include <threads.h>
#include <time.h>
int main(void)
{
mtx_t mutex;
struct timespec deadline;
if (mtx_init(&mutex, mtx_timed) != thrd_success)
return 1;
if (timespec_get(&deadline, TIME_UTC) != TIME_UTC) {
mtx_destroy(&mutex);
return 1;
}
deadline.tv_sec += 1;
int result = mtx_timedlock(&mutex, &deadline);
if (result == thrd_success) {
if (mtx_unlock(&mutex) != thrd_success)
return 1;
puts("locked");
} else if (result == thrd_timedout) {
puts("timeout");
} else {
mtx_destroy(&mutex);
return 1;
}
mtx_destroy(&mutex);
return 0;
}Wynik
locked
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.