Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

cnd_timedwait — fonction de variable de condition C23

`cnd_timedwait(cond, mtx, ts)` déverrouille atomiquement le `mtx` détenu et attend un signal/broadcast, l’heure civile absolue `TIME_UTC` de `*ts` ou un déblocage non spécifié. Avant un retour normal, elle verrouille de nouveau ce mutex.

Version : C23

Syntaxe

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

cnd_timedwait(cond, mtx, ts) déverrouille atomiquement le mtx détenu et attend un signal/broadcast, l’heure civile absolue TIME_UTC de *ts ou un déblocage non spécifié. Avant un retour normal, elle verrouille de nouveau ce mutex.

L’exemple verrouille le mutex, crée un instant une seconde dans le passé et appelle réellement cnd_timedwait sans signal. 1 1 signifie thrd_timedout et un mtx_unlock réussi, montrant que l’appelant possède de nouveau le mutex après timeout.

L’appelant doit déjà détenir mtx ; *ts est une échéance TIME_UTC, pas une durée relative. Testez thrd_success, thrd_timedout et thrd_error, puis réévaluez le prédicat en boucle après succès ou timeout, car un réveil — même non spécifié — ne rend pas la condition vraie.

Exemples

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

Résultat

1 1

L’exemple verrouille le mutex, crée un instant une seconde dans le passé et appelle réellement `cnd_timedwait` sans signal. `1 1` signifie `thrd_timedout` et un `mtx_unlock` réussi, montrant que l’appelant possède de nouveau le mutex après timeout.

Sources