Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje