Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti