Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

cnd_init — funkcja zmiennej warunkowej C23

`cnd_init(cond)` tworzy nową zmienną warunkową i po sukcesie zapisuje w `*cond` wartość jednoznacznie identyfikującą ten obiekt. Zwraca `thrd_success`, `thrd_nomem` przy braku pamięci albo `thrd_error`, gdy żądania nie można spełnić.

Wersja: C23

Składnia

int cnd_init(cnd_t *cond);

cnd_init(cond) tworzy nową zmienną warunkową i po sukcesie zapisuje w *cond wartość jednoznacznie identyfikującą ten obiekt. Zwraca thrd_success, thrd_nomem przy braku pamięci albo thrd_error, gdy żądania nie można spełnić.

Przykład sprawdza wynik inicjalizacji przed użyciem obiektu, następnie wywołuje cnd_signal bez oczekujących — co ma dać sukces — i bezpiecznie niszczy zmienną. Wynik 1 1 potwierdza oba kody sukcesu.

Po błędzie zawartości *cond nie wolno używać ani niszczyć jako poprawnej zmiennej. Nowo utworzona zmienna nie przechowuje stanu „zasygnalizowano”: oczekujący blokuje, dopóki nie dostanie późniejszego sygnału lub nie zostanie odblokowany z nieokreślonego powodu; używaj tego samego obiektu, nie jego kopii bajtowej.

Przykłady

#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;
}

Wynik

1 1

Przykład sprawdza wynik inicjalizacji przed użyciem obiektu, następnie wywołuje `cnd_signal` bez oczekujących — co ma dać sukces — i bezpiecznie niszczy zmienną. Wynik `1 1` potwierdza oba kody sukcesu.

Źródła