Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

cnd_timedwait — funkcia podmienkovej premennej C23

`cnd_timedwait(cond, mtx, ts)` atomicky odomkne držaný `mtx` a čaká na signál/broadcast, absolútny systémový čas `TIME_UTC` v `*ts` alebo odblokovanie z neurčeného dôvodu. Pred normálnym návratom mutex znovu zamkne.

Verzia: C23

Syntax

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

cnd_timedwait(cond, mtx, ts) atomicky odomkne držaný mtx a čaká na signál/broadcast, absolútny systémový čas TIME_UTC v *ts alebo odblokovanie z neurčeného dôvodu. Pred normálnym návratom mutex znovu zamkne.

Príklad zamkne mutex, vytvorí okamih o sekundu v minulosti a bez signálu skutočne zavolá cnd_timedwait. 1 1 znamená thrd_timedout a úspešný mtx_unlock, teda že volajúci po timeout mutex opäť vlastní.

Volajúci už musí vlastniť mtx; *ts je termín TIME_UTC, nie relatívna doba. Kontrolujte thrd_success, thrd_timedout aj thrd_error a po úspechu či timeout znovu overte predikát v slučke, pretože prebudenie — aj z neurčeného dôvodu — podmienku nesplní.

Príklady

#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;
}

Výsledok

1 1

Príklad zamkne mutex, vytvorí okamih o sekundu v minulosti a bez signálu skutočne zavolá `cnd_timedwait`. `1 1` znamená `thrd_timedout` a úspešný `mtx_unlock`, teda že volajúci po timeout mutex opäť vlastní.

Zdroje