CKTIS / C
cnd_timedwait — funkce podmínkové proměnné C23
`cnd_timedwait(cond, mtx, ts)` atomicky odemkne držený `mtx` a čeká na signál/broadcast, absolutní systémový čas `TIME_UTC` v `*ts` nebo odblokování z neurčeného důvodu. Před normálním návratem mutex znovu zamkne.
Verze: C23
Syntaxe
int cnd_timedwait(cnd_t *restrict cond, mtx_t *restrict mtx, const struct timespec *restrict ts);cnd_timedwait(cond, mtx, ts) atomicky odemkne držený mtx a čeká na signál/broadcast, absolutní systémový čas TIME_UTC v *ts nebo odblokování z neurčeného důvodu. Před normálním návratem mutex znovu zamkne.
Příklad zamkne mutex, vytvoří okamžik o sekundu v minulosti a bez signálu skutečně zavolá cnd_timedwait. 1 1 znamená thrd_timedout a úspěšný mtx_unlock, tedy že volající po timeout mutex opět vlastní.
Volající už musí vlastnit mtx; *ts je termín TIME_UTC, ne relativní doba. Kontrolujte thrd_success, thrd_timedout i thrd_error a po úspěchu či timeout znovu ověřte predikát ve smyčce, protože probuzení — i z neurčeného důvodu — podmínku nesplní.
Příklady
#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;
}
Výsledek
1 1
Příklad zamkne mutex, vytvoří okamžik o sekundu v minulosti a bez signálu skutečně zavolá `cnd_timedwait`. `1 1` znamená `thrd_timedout` a úspěšný `mtx_unlock`, tedy že volající po timeout mutex opět vlastní.