Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C

cnd_timedwait — funkcija uvjetne varijable C23

`cnd_timedwait(cond, mtx, ts)` atomski otključava stečeni `mtx` i čeka signal/broadcast, apsolutno sistemsko vrijeme `TIME_UTC` u `*ts` ili odblokiranje iz nespecificiranog razloga. Prije normalnog povratka ponovno zaključava mutex.

Verzija: C23

Sintaksa

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

cnd_timedwait(cond, mtx, ts) atomski otključava stečeni mtx i čeka signal/broadcast, apsolutno sistemsko vrijeme TIME_UTC u *ts ili odblokiranje iz nespecificiranog razloga. Prije normalnog povratka ponovno zaključava mutex.

Primjer zaključava mutex, stvara vremensku točku jednu sekundu u prošlosti i bez signala doista poziva cnd_timedwait. 1 1 znači thrd_timedout i uspješan mtx_unlock, pokazujući da pozivatelj nakon timeout opet posjeduje mutex.

Pozivatelj već mora posjedovati mtx; *ts je rok TIME_UTC, ne relativno trajanje. Provjeri thrd_success, thrd_timedout i thrd_error, a nakon uspjeha ili timeout ponovno provjeravaj predikat u petlji jer buđenje — i nespecificirano — ne čini uvjet istinitim.

Primjeri

#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;
}

Rezultat

1 1

Primjer zaključava mutex, stvara vremensku točku jednu sekundu u prošlosti i bez signala doista poziva `cnd_timedwait`. `1 1` znači `thrd_timedout` i uspješan `mtx_unlock`, pokazujući da pozivatelj nakon timeout opet posjeduje mutex.

Izvori