Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła