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.