Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

cnd_wait — čakalna funkcija C23

`cnd_wait(cond, mtx)` iz `<threads.h>` atomsko odklene posedovani `mtx` in blokira do signala, broadcasta ali odblokiranja iz nedoločenega razloga. Pred vrnitvijo `mtx` znova zaklene; vrne `thrd_success` ali `thrd_error`.

Različica: C23

Sintaksa

int cnd_wait(cnd_t *cond, mtx_t *mtx);

cnd_wait(cond, mtx) iz <threads.h> atomsko odklene posedovani mtx in blokira do signala, broadcasta ali odblokiranja iz nedoločenega razloga. Pred vrnitvijo mtx znova zaklene; vrne thrd_success ali thrd_error.

Primer zažene delovno nit, ki nastavi waiting, čaka na zaščiteni predikat ready in po signalu prebere payload. 1 42 potrdi uspešen cnd_wait, ponovno pridobitev mutexa in vidnost podatkov pod istim mutexom.

Klicatelj mora že posedovati mtx, oba kazalca pa morata označevati živa pravilno inicializirana objekta. Obvestila se ne shranijo in prebujenje ne dokazuje pogoja, zato predikat preverjajte v zanki; po napaki podatkov ne uporabite kot po uspešnem čakanju.

Primeri

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

static mtx_t mutex;
static cnd_t condition;
static atomic_int waiting;
static int ready;
static int payload;
static int observed;

static int worker(void *unused) {
    (void)unused;
    if (mtx_lock(&mutex) != thrd_success) return 1;
    atomic_store(&waiting, 1);
    while (!ready) {
        if (cnd_wait(&condition, &mutex) != thrd_success) {
            mtx_unlock(&mutex);
            return 1;
        }
    }
    observed = payload;
    return mtx_unlock(&mutex) == thrd_success ? 0 : 1;
}

int main(void) {
    if (mtx_init(&mutex, mtx_plain) != thrd_success) return 1;
    if (cnd_init(&condition) != thrd_success) {
        mtx_destroy(&mutex);
        return 1;
    }
    thrd_t thread;
    if (thrd_create(&thread, worker, NULL) != thrd_success) return 1;
    while (!atomic_load(&waiting)) thrd_yield();
    if (mtx_lock(&mutex) != thrd_success) return 1;
    payload = 42;
    ready = 1;
    if (cnd_signal(&condition) != thrd_success) return 1;
    if (mtx_unlock(&mutex) != thrd_success) return 1;
    int worker_result;
    if (thrd_join(thread, &worker_result) != thrd_success) return 1;
    printf("%d %d\n", worker_result == 0, observed);
    cnd_destroy(&condition);
    mtx_destroy(&mutex);
    return 0;
}

Rezultat

1 42

Primer zažene delovno nit, ki nastavi `waiting`, čaka na zaščiteni predikat `ready` in po signalu prebere `payload`. `1 42` potrdi uspešen `cnd_wait`, ponovno pridobitev mutexa in vidnost podatkov pod istim mutexom.

Viri