Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

cnd_timedwait — funzione per condition variable C23

`cnd_timedwait(cond, mtx, ts)` sblocca atomicamente il `mtx` posseduto e attende un segnale/broadcast, l’ora civile assoluta `TIME_UTC` in `*ts` o uno sblocco per ragione non specificata. Prima del ritorno normale blocca di nuovo il mutex.

Versione: C23

Sintassi

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

cnd_timedwait(cond, mtx, ts) sblocca atomicamente il mtx posseduto e attende un segnale/broadcast, l’ora civile assoluta TIME_UTC in *ts o uno sblocco per ragione non specificata. Prima del ritorno normale blocca di nuovo il mutex.

L’esempio blocca il mutex, crea un istante un secondo nel passato e chiama davvero cnd_timedwait senza segnale. 1 1 significa thrd_timedout e mtx_unlock riuscito, mostrando che il chiamante possiede di nuovo il mutex dopo il timeout.

Il chiamante deve già possedere mtx; *ts è una scadenza TIME_UTC, non una durata relativa. Controlla thrd_success, thrd_timedout e thrd_error, e dopo successo o timeout rivaluta il predicato in un ciclo, poiché il risveglio — anche non specificato — non rende vera la condizione.

Esempi

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

Risultato

1 1

L’esempio blocca il mutex, crea un istante un secondo nel passato e chiama davvero `cnd_timedwait` senza segnale. `1 1` significa `thrd_timedout` e `mtx_unlock` riuscito, mostrando che il chiamante possiede di nuovo il mutex dopo il timeout.

Fonti