Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

cnd_destroy — funkcja zmiennej warunkowej C23

`cnd_destroy(cond)` zwalnia wszystkie zasoby używane przez wcześniej zainicjalizowaną zmienną warunkową i niczego nie zwraca. C23 wymaga, aby podczas wywołania żaden wątek nie był na niej zablokowany.

Wersja: C23

Składnia

void cnd_destroy(cnd_t *cond);

cnd_destroy(cond) zwalnia wszystkie zasoby używane przez wcześniej zainicjalizowaną zmienną warunkową i niczego nie zwraca. C23 wymaga, aby podczas wywołania żaden wątek nie był na niej zablokowany.

Przykład najpierw sprawdza sukces cnd_init, następnie przy zerowej liczbie oczekujących rzeczywiście wywołuje cnd_destroy i drukuje released 0, dokumentując bezpieczną kolejność życia obiektu.

Zniszcz dopiero po obudzeniu i dołączeniu wszystkich użytkowników; samo ustawienie predykatu bez join nie dowodzi braku oczekujących. Po cnd_destroy nie wolno sygnalizować, czekać ani niszczyć ponownie tego obiektu, dopóki kolejne cnd_init nie zakończy się sukcesem.

Przykłady

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

Wynik

released 0

Przykład najpierw sprawdza sukces `cnd_init`, następnie przy zerowej liczbie oczekujących rzeczywiście wywołuje `cnd_destroy` i drukuje `released 0`, dokumentując bezpieczną kolejność życia obiektu.

Źródła