CKTIS / C
cnd_wait — C23-wachtfunctie
`cnd_wait(cond, mtx)` uit `<threads.h>` ontgrendelt atomair de gehouden `mtx` en blokkeert tot een signaal, broadcast of deblokkering om ongespecificeerde reden. Voor terugkeer vergrendelt ze `mtx` opnieuw; resultaat is `thrd_success` of `thrd_error`.
Versie: C23
Syntax
int cnd_wait(cnd_t *cond, mtx_t *mtx);cnd_wait(cond, mtx) uit <threads.h> ontgrendelt atomair de gehouden mtx en blokkeert tot een signaal, broadcast of deblokkering om ongespecificeerde reden. Voor terugkeer vergrendelt ze mtx opnieuw; resultaat is thrd_success of thrd_error.
Het voorbeeld start een worker die waiting zet, op het beschermde predicaat ready wacht en na het signaal payload leest. 1 42 bevestigt geslaagde cnd_wait, herverwerving van de mutex en zichtbaarheid van gegevens onder dezelfde mutex.
De aanroeper moet mtx al bezitten en beide pointers moeten levende, correct geïnitialiseerde objecten aanwijzen. Meldingen worden niet gebufferd en ontwaken bewijst de conditie niet: test het predicaat in een lus; gebruik na een fout de gegevens niet alsof wachten slaagde.
Voorbeelden
#include <stdatomic.h>
#include <stdio.h>
#include <threads.h>
static mtx_t mutex;
static cnd_t condition;
static atomic_int waiting;
static int ready;
static int payload;
static int observed;
static int worker(void *unused) {
(void)unused;
if (mtx_lock(&mutex) != thrd_success) return 1;
atomic_store(&waiting, 1);
while (!ready) {
if (cnd_wait(&condition, &mutex) != thrd_success) {
mtx_unlock(&mutex);
return 1;
}
}
observed = payload;
return mtx_unlock(&mutex) == thrd_success ? 0 : 1;
}
int main(void) {
if (mtx_init(&mutex, mtx_plain) != thrd_success) return 1;
if (cnd_init(&condition) != thrd_success) {
mtx_destroy(&mutex);
return 1;
}
thrd_t thread;
if (thrd_create(&thread, worker, NULL) != thrd_success) return 1;
while (!atomic_load(&waiting)) thrd_yield();
if (mtx_lock(&mutex) != thrd_success) return 1;
payload = 42;
ready = 1;
if (cnd_signal(&condition) != thrd_success) return 1;
if (mtx_unlock(&mutex) != thrd_success) return 1;
int worker_result;
if (thrd_join(thread, &worker_result) != thrd_success) return 1;
printf("%d %d\n", worker_result == 0, observed);
cnd_destroy(&condition);
mtx_destroy(&mutex);
return 0;
}
Resultaat
1 42
Het voorbeeld start een worker die `waiting` zet, op het beschermde predicaat `ready` wacht en na het signaal `payload` leest. `1 42` bevestigt geslaagde `cnd_wait`, herverwerving van de mutex en zichtbaarheid van gegevens onder dezelfde mutex.