KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

cnd_timedwait — C23-conditievariabelefunctie

`cnd_timedwait(cond, mtx, ts)` ontgrendelt atomair de gehouden `mtx` en wacht op signal/broadcast, de absolute `TIME_UTC`-systeemtijd in `*ts` of deblokkering om ongespecificeerde reden. Vóór normale terugkeer vergrendelt het de mutex opnieuw.

Versie: C23

Syntax

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

cnd_timedwait(cond, mtx, ts) ontgrendelt atomair de gehouden mtx en wacht op signal/broadcast, de absolute TIME_UTC-systeemtijd in *ts of deblokkering om ongespecificeerde reden. Vóór normale terugkeer vergrendelt het de mutex opnieuw.

Het voorbeeld vergrendelt de mutex, maakt een tijdstip één seconde in het verleden en roept zonder signaal werkelijk cnd_timedwait aan. 1 1 betekent thrd_timedout en geslaagde mtx_unlock, dus de aanroeper bezit de mutex na timeout weer.

De aanroeper moet mtx al bezitten; *ts is een TIME_UTC-deadline, geen relatieve duur. Controleer thrd_success, thrd_timedout en thrd_error en toets na succes of timeout het predicaat opnieuw in een lus, want ontwaken — ook ongespecificeerd — maakt de conditie niet waar.

Voorbeelden

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

Resultaat

1 1

Het voorbeeld vergrendelt de mutex, maakt een tijdstip één seconde in het verleden en roept zonder signaal werkelijk `cnd_timedwait` aan. `1 1` betekent `thrd_timedout` en geslaagde `mtx_unlock`, dus de aanroeper bezit de mutex na timeout weer.

Bronnen