CKTIS / C
cnd_init — funkcija pogojne spremenljivke C23
`cnd_init(cond)` ustvari novo pogojno spremenljivko in ob uspehu v `*cond` shrani vrednost, ki jo enolično določa. Vrne `thrd_success`, `thrd_nomem`, če ni mogoče dodeliti pomnilnika, ali `thrd_error`, če zahteve ni mogoče izpolniti.
Različica: C23
Sintaksa
int cnd_init(cnd_t *cond);cnd_init(cond) ustvari novo pogojno spremenljivko in ob uspehu v *cond shrani vrednost, ki jo enolično določa. Vrne thrd_success, thrd_nomem, če ni mogoče dodeliti pomnilnika, ali thrd_error, če zahteve ni mogoče izpolniti.
Primer preveri rezultat pred uporabo objekta, nato pokliče cnd_signal brez čakajočih — kar mora uspeti — in varno uniči spremenljivko. Izpis 1 1 potrdi obe kodi uspeha.
Po napaki vsebine *cond ne uporabljajte ali uničujte kot veljavne spremenljivke. Nova pogojna spremenljivka ne hrani stanja “signalizirano”: čakajoča nit blokira do poznejšega signala ali nedoločenega odblokiranja; uporabljajte isti inicializirani objekt, ne njegove bajtne kopije.
Primeri
#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;
}
Rezultat
1 1
Primer preveri rezultat pred uporabo objekta, nato pokliče `cnd_signal` brez čakajočih — kar mora uspeti — in varno uniči spremenljivko. Izpis `1 1` potrdi obe kodi uspeha.