CKTIS / C
cnd_init — funzione per condition variable C23
`cnd_init(cond)` crea una nuova condition variable e, se riesce, memorizza in `*cond` un valore che la identifica univocamente. Restituisce `thrd_success`, `thrd_nomem` se manca memoria o `thrd_error` se la richiesta non può essere soddisfatta.
Versione: C23
Sintassi
int cnd_init(cnd_t *cond);cnd_init(cond) crea una nuova condition variable e, se riesce, memorizza in *cond un valore che la identifica univocamente. Restituisce thrd_success, thrd_nomem se manca memoria o thrd_error se la richiesta non può essere soddisfatta.
L’esempio controlla il risultato prima di usare l’oggetto, poi chiama cnd_signal senza waiter — operazione che deve riuscire — e distrugge in sicurezza la variabile. L’output 1 1 conferma entrambi i codici di successo.
Dopo un errore non usare né distruggere il contenuto di *cond come variabile valida. Una nuova condizione non conserva uno stato “segnalato”: l’attesa blocca fino a un segnale successivo o sblocco per ragione non specificata; usa lo stesso oggetto inizializzato, non una copia byte per byte.
Esempi
#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;
}
Risultato
1 1
L’esempio controlla il risultato prima di usare l’oggetto, poi chiama `cnd_signal` senza waiter — operazione che deve riuscire — e distrugge in sicurezza la variabile. L’output `1 1` conferma entrambi i codici di successo.