Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

cnd_timedwait — funkcja zmiennej warunkowej C23

`cnd_timedwait(cond, mtx, ts)` atomowo odblokowuje posiadany `mtx` i czeka na sygnał/broadcast, upływ absolutnego czasu kalendarzowego `TIME_UTC` w `*ts` albo odblokowanie z nieokreślonego powodu. Przed normalnym powrotem ponownie blokuje ten mutex.

Wersja: C23

Składnia

int cnd_timedwait(cnd_t *restrict cond, mtx_t *restrict mtx, const struct timespec *restrict ts);

cnd_timedwait(cond, mtx, ts) atomowo odblokowuje posiadany mtx i czeka na sygnał/broadcast, upływ absolutnego czasu kalendarzowego TIME_UTC w *ts albo odblokowanie z nieokreślonego powodu. Przed normalnym powrotem ponownie blokuje ten mutex.

Przykład blokuje mutex, tworzy punkt czasu o sekundę w przeszłości i naprawdę wywołuje cnd_timedwait bez sygnału. Wynik 1 1 oznacza thrd_timedout oraz udane mtx_unlock, co pokazuje, że po timeout mutex znów należy do wywołującego.

Wywołujący musi już posiadać mtx; *ts jest terminem TIME_UTC, nie względnym okresem. Sprawdzaj thrd_success, thrd_timedout i thrd_error, a po sukcesie lub timeout ponownie badaj predykat w pętli, ponieważ samo przebudzenie — także z nieokreślonego powodu — nie czyni warunku prawdziwym.

Przykłady

#include <stdio.h>
#include <threads.h>
#include <time.h>

int main(void) {
    mtx_t mutex;
    cnd_t condition;
    if (mtx_init(&mutex, mtx_plain) != thrd_success) return 1;
    if (cnd_init(&condition) != thrd_success) return 1;
    struct timespec deadline;
    if (timespec_get(&deadline, TIME_UTC) != TIME_UTC) return 1;
    if (deadline.tv_sec > 0) deadline.tv_sec -= 1;
    if (mtx_lock(&mutex) != thrd_success) return 1;
    int result = cnd_timedwait(&condition, &mutex, &deadline);
    int unlocked = mtx_unlock(&mutex);
    printf("%d %d\n", result == thrd_timedout, unlocked == thrd_success);
    cnd_destroy(&condition);
    mtx_destroy(&mutex);
    return 0;
}

Wynik

1 1

Przykład blokuje mutex, tworzy punkt czasu o sekundę w przeszłości i naprawdę wywołuje `cnd_timedwait` bez sygnału. Wynik `1 1` oznacza `thrd_timedout` oraz udane `mtx_unlock`, co pokazuje, że po timeout mutex znów należy do wywołującego.

Źródła