CKTIS / C
cnd_init — C23-Condition-Variable-Funktion
`cnd_init(cond)` erzeugt eine neue Condition Variable und speichert bei Erfolg in `*cond` einen sie eindeutig identifizierenden Wert. Rückgabe ist `thrd_success`, bei Speichermangel `thrd_nomem` oder `thrd_error`, wenn die Anforderung nicht erfüllbar ist.
Version: C23
Syntax
int cnd_init(cnd_t *cond);cnd_init(cond) erzeugt eine neue Condition Variable und speichert bei Erfolg in *cond einen sie eindeutig identifizierenden Wert. Rückgabe ist thrd_success, bei Speichermangel thrd_nomem oder thrd_error, wenn die Anforderung nicht erfüllbar ist.
Das Beispiel prüft das Initialisierungsergebnis vor der Verwendung, ruft dann cnd_signal ohne Wartende auf — was erfolgreich sein muss — und zerstört die Variable sicher. 1 1 bestätigt beide Erfolgscodes.
Nach einem Fehler darf der Inhalt von *cond nicht als gültige Variable benutzt oder zerstört werden. Ein neues Objekt speichert keinen Zustand „signalisiert“: Ein Wartender blockiert bis zu einem späteren Signal oder unbestimmten Entsperrgrund; verwenden Sie dasselbe Objekt, keine Bytekopie als zweite Variable.
Beispiele
#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;
}
Ergebnis
1 1
Das Beispiel prüft das Initialisierungsergebnis vor der Verwendung, ruft dann `cnd_signal` ohne Wartende auf — was erfolgreich sein muss — und zerstört die Variable sicher. `1 1` bestätigt beide Erfolgscodes.