Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes