Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

cnd_init — fonction de variable de condition C23

`cnd_init(cond)` crée une nouvelle variable de condition et, en cas de succès, place dans `*cond` une valeur qui l’identifie de manière unique. Elle renvoie `thrd_success`, `thrd_nomem` si la mémoire manque, ou `thrd_error` si la requête ne peut être satisfaite.

Version : C23

Syntaxe

int cnd_init(cnd_t *cond);

cnd_init(cond) crée une nouvelle variable de condition et, en cas de succès, place dans *cond une valeur qui l’identifie de manière unique. Elle renvoie thrd_success, thrd_nomem si la mémoire manque, ou thrd_error si la requête ne peut être satisfaite.

L’exemple vérifie l’initialisation avant d’utiliser l’objet, appelle ensuite cnd_signal sans attente — ce qui doit réussir — puis détruit sûrement la variable. La sortie 1 1 confirme les deux codes de succès.

Après un échec, n’utilisez ni ne détruisez le contenu de *cond comme variable valide. Une nouvelle condition ne mémorise pas un état « signalé » : une attente bloque jusqu’à un signal ultérieur ou un déblocage non spécifié ; utilisez le même objet initialisé et non une copie octet par octet.

Exemples

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

Résultat

1 1

L’exemple vérifie l’initialisation avant d’utiliser l’objet, appelle ensuite `cnd_signal` sans attente — ce qui doit réussir — puis détruit sûrement la variable. La sortie `1 1` confirme les deux codes de succès.

Sources