CKTIS / C
cnd_init — função de variável de condição C23
`cnd_init(cond)` cria uma nova variável de condição e, no sucesso, guarda em `*cond` um valor que a identifica univocamente. Devolve `thrd_success`, `thrd_nomem` se não puder alocar memória ou `thrd_error` se o pedido não puder ser cumprido.
Versão: C23
Sintaxe
int cnd_init(cnd_t *cond);cnd_init(cond) cria uma nova variável de condição e, no sucesso, guarda em *cond um valor que a identifica univocamente. Devolve thrd_success, thrd_nomem se não puder alocar memória ou thrd_error se o pedido não puder ser cumprido.
O exemplo verifica o resultado antes de usar o objeto, chama depois cnd_signal sem threads à espera — o que tem de ter sucesso — e destrói a variável em segurança. A saída 1 1 confirma os dois códigos de sucesso.
Após falha, não uses nem destruas o conteúdo de *cond como variável válida. Uma condição nova não guarda estado “sinalizado”: a espera bloqueia até sinal posterior ou desbloqueio por motivo não especificado; usa o mesmo objeto inicializado, não uma cópia byte a byte.
Exemplos
#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;
}
Resultado
1 1
O exemplo verifica o resultado antes de usar o objeto, chama depois `cnd_signal` sem threads à espera — o que tem de ter sucesso — e destrói a variável em segurança. A saída `1 1` confirma os dois códigos de sucesso.