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

CKTIS / C

cnd_timedwait — função de variável de condição C23

`cnd_timedwait(cond, mtx, ts)` desbloqueia atomicamente o `mtx` possuído e espera sinal/broadcast, a hora civil absoluta `TIME_UTC` em `*ts` ou desbloqueio por motivo não especificado. Antes do retorno normal bloqueia novamente o mutex.

Versão: C23

Sintaxe

int cnd_timedwait(cnd_t *restrict cond, mtx_t *restrict mtx, const struct timespec *restrict ts);

cnd_timedwait(cond, mtx, ts) desbloqueia atomicamente o mtx possuído e espera sinal/broadcast, a hora civil absoluta TIME_UTC em *ts ou desbloqueio por motivo não especificado. Antes do retorno normal bloqueia novamente o mutex.

O exemplo bloqueia o mutex, cria um instante um segundo no passado e chama realmente cnd_timedwait sem sinal. 1 1 significa thrd_timedout e mtx_unlock bem-sucedido, mostrando que o chamador volta a possuir o mutex após timeout.

O chamador já tem de possuir mtx; *ts é um prazo TIME_UTC, não duração relativa. Verifica thrd_success, thrd_timedout e thrd_error, e após sucesso ou timeout reavalia o predicado num ciclo, pois acordar — também por motivo não especificado — não torna a condição verdadeira.

Exemplos

#include <stdio.h>
#include <threads.h>
#include <time.h>

int main(void) {
    mtx_t mutex;
    cnd_t condition;
    if (mtx_init(&mutex, mtx_plain) != thrd_success) return 1;
    if (cnd_init(&condition) != thrd_success) return 1;
    struct timespec deadline;
    if (timespec_get(&deadline, TIME_UTC) != TIME_UTC) return 1;
    if (deadline.tv_sec > 0) deadline.tv_sec -= 1;
    if (mtx_lock(&mutex) != thrd_success) return 1;
    int result = cnd_timedwait(&condition, &mutex, &deadline);
    int unlocked = mtx_unlock(&mutex);
    printf("%d %d\n", result == thrd_timedout, unlocked == thrd_success);
    cnd_destroy(&condition);
    mtx_destroy(&mutex);
    return 0;
}

Resultado

1 1

O exemplo bloqueia o mutex, cria um instante um segundo no passado e chama realmente `cnd_timedwait` sem sinal. `1 1` significa `thrd_timedout` e `mtx_unlock` bem-sucedido, mostrando que o chamador volta a possuir o mutex após timeout.

Fontes