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.