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.