WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

cnd_destroy — C23-Condition-Variable-Funktion

`cnd_destroy(cond)` gibt alle Ressourcen einer zuvor initialisierten Condition Variable frei und liefert keinen Wert. C23 verlangt, dass zum Aufrufzeitpunkt kein Thread darauf blockiert ist.

Version: C23

Syntax

void cnd_destroy(cnd_t *cond);

cnd_destroy(cond) gibt alle Ressourcen einer zuvor initialisierten Condition Variable frei und liefert keinen Wert. C23 verlangt, dass zum Aufrufzeitpunkt kein Thread darauf blockiert ist.

Das Beispiel prüft zuerst den Erfolg von cnd_init, ruft dann bei null Wartenden wirklich cnd_destroy auf und gibt released 0 aus; damit zeigt es die sichere Lebensdauerreihenfolge.

Erst zerstören, nachdem alle Benutzer geweckt und gejoint wurden; nur das Setzen eines Prädikats beweist ohne Join nicht, dass niemand wartet. Nach cnd_destroy darf dieses Objekt bis zu einem neuen erfolgreichen cnd_init weder signalisiert, abgewartet noch erneut zerstört werden.

Beispiele

#include <stdio.h>
#include <threads.h>

int main(void) {
    cnd_t condition;
    if (cnd_init(&condition) != thrd_success) return 1;
    int waiters = 0;
    cnd_destroy(&condition);
    printf("released %d\n", waiters);
    return 0;
}

Ergebnis

released 0

Das Beispiel prüft zuerst den Erfolg von `cnd_init`, ruft dann bei null Wartenden wirklich `cnd_destroy` auf und gibt `released 0` aus; damit zeigt es die sichere Lebensdauerreihenfolge.

Quellen