CKTIS / C
cnd_init — C23-conditievariabelefunctie
`cnd_init(cond)` maakt een nieuwe conditievariabele en schrijft bij succes in `*cond` een waarde die haar uniek identificeert. De functie retourneert `thrd_success`, `thrd_nomem` als geheugen niet kan worden toegewezen, of `thrd_error` als het verzoek niet uitvoerbaar is.
Versie: C23
Syntax
int cnd_init(cnd_t *cond);cnd_init(cond) maakt een nieuwe conditievariabele en schrijft bij succes in *cond een waarde die haar uniek identificeert. De functie retourneert thrd_success, thrd_nomem als geheugen niet kan worden toegewezen, of thrd_error als het verzoek niet uitvoerbaar is.
Het voorbeeld controleert het resultaat vóór gebruik, roept daarna cnd_signal aan zonder wachtenden — dit moet slagen — en vernietigt de variabele veilig. Uitvoer 1 1 bevestigt beide succescodes.
Gebruik of vernietig na een fout de inhoud van *cond niet als geldige conditievariabele. Een nieuw object bewaart geen “gesignaleerd” toestand: een wachtende blokkeert tot een later signaal of ongespecificeerde deblokkering; gebruik hetzelfde geïnitialiseerde object, niet een bytekopie als tweede conditie.
Voorbeelden
#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;
}
Resultaat
1 1
Het voorbeeld controleert het resultaat vóór gebruik, roept daarna `cnd_signal` aan zonder wachtenden — dit moet slagen — en vernietigt de variabele veilig. Uitvoer `1 1` bevestigt beide succescodes.