CKTIS / C
cnd_init — funkce podmínkové proměnné C23
`cnd_init(cond)` vytvoří novou podmínkovou proměnnou a při úspěchu uloží do `*cond` hodnotu, která ji jednoznačně identifikuje. Vrací `thrd_success`, `thrd_nomem` při nedostatku paměti nebo `thrd_error`, nelze-li požadavek splnit.
Verze: C23
Syntaxe
int cnd_init(cnd_t *cond);cnd_init(cond) vytvoří novou podmínkovou proměnnou a při úspěchu uloží do *cond hodnotu, která ji jednoznačně identifikuje. Vrací thrd_success, thrd_nomem při nedostatku paměti nebo thrd_error, nelze-li požadavek splnit.
Příklad ověří výsledek před použitím objektu, potom zavolá cnd_signal bez čekajících — což musí uspět — a proměnnou bezpečně zničí. Výstup 1 1 potvrzuje oba kódy úspěchu.
Po chybě nepoužívejte ani neničte obsah *cond jako platnou proměnnou. Nová podmínka neuchovává stav „signalizováno“: čekající blokuje do pozdějšího signálu či odblokování z neurčeného důvodu; používejte tentýž inicializovaný objekt, ne jeho bajtovou kopii.
Příklady
#include <stdio.h>
#include <threads.h>
int main(void) {
cnd_t condition;
int initialized = cnd_init(&condition);
if (initialized != thrd_success) return 1;
int signalled_without_waiters = cnd_signal(&condition);
printf("%d %d\n", initialized == thrd_success, signalled_without_waiters == thrd_success);
cnd_destroy(&condition);
return 0;
}
Výsledek
1 1
Příklad ověří výsledek před použitím objektu, potom zavolá `cnd_signal` bez čekajících — což musí uspět — a proměnnou bezpečně zničí. Výstup `1 1` potvrzuje oba kódy úspěchu.