WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen