CKTIS / C
cnd_timedwait — C23-Condition-Variable-Funktion
`cnd_timedwait(cond, mtx, ts)` entsperrt den gehaltenen `mtx` atomar und wartet auf Signal/Broadcast, die absolute `TIME_UTC`-Kalenderzeit in `*ts` oder Entsperren aus unbestimmtem Grund. Vor normaler Rückkehr sperrt es den Mutex erneut.
Version: C23
Syntax
int cnd_timedwait(cnd_t *restrict cond, mtx_t *restrict mtx, const struct timespec *restrict ts);cnd_timedwait(cond, mtx, ts) entsperrt den gehaltenen mtx atomar und wartet auf Signal/Broadcast, die absolute TIME_UTC-Kalenderzeit in *ts oder Entsperren aus unbestimmtem Grund. Vor normaler Rückkehr sperrt es den Mutex erneut.
Das Beispiel sperrt den Mutex, erzeugt einen Zeitpunkt eine Sekunde in der Vergangenheit und ruft ohne Signal wirklich cnd_timedwait auf. 1 1 bedeutet thrd_timedout und erfolgreiches mtx_unlock; der Aufrufer besitzt den Mutex nach Timeout wieder.
Der Aufrufer muss mtx bereits besitzen; *ts ist eine TIME_UTC-Deadline, keine relative Dauer. thrd_success, thrd_timedout und thrd_error prüfen und nach Erfolg oder Timeout das Prädikat in einer Schleife neu bewerten, da Aufwachen — auch aus unbestimmtem Grund — die Bedingung nicht wahr macht.
Beispiele
#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;
}
Ergebnis
1 1
Das Beispiel sperrt den Mutex, erzeugt einen Zeitpunkt eine Sekunde in der Vergangenheit und ruft ohne Signal wirklich `cnd_timedwait` auf. `1 1` bedeutet `thrd_timedout` und erfolgreiches `mtx_unlock`; der Aufrufer besitzt den Mutex nach Timeout wieder.