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

CKTIS / C

call_once — knižničná funkcia C23

`call_once(flag, func)` použije `once_flag`, aby zavolala `func` práve raz pri prvom účinnom volaní s týmto objektom, a nič nevracia. Dokončenie sa synchronizuje s každým ďalším volaním rovnakého príznaku: s už prebiehajúcimi volajúcimi čakajúcimi na `func` aj s neskoršími.

Verzia: C23

Syntax

void call_once(once_flag *flag, void (*func)(void));

call_once(flag, func) použije once_flag, aby zavolala func práve raz pri prvom účinnom volaní s týmto objektom, a nič nevracia. Dokončenie sa synchronizuje s každým ďalším volaním rovnakého príznaku: s už prebiehajúcimi volajúcimi čakajúcimi na func aj s neskoršími.

Slúži na bezpečnú lenivú inicializáciu zdieľaného stavu. V príklade dve vlákna volajú call_once, ale inicializátor zvýši počítadlo iba raz a zverejní value = 42; po join je výsledok 1 42.

Príznak musí byť inicializovaný ONCE_FLAG_INIT a zostať tým istým objektom; nekopírujte ho ani neresetujte. func má typ void(void) a call_once nevracia chybu. Implementácia s __STDC_NO_THREADS__ môže vynechať <threads.h>; rekurzívne použitie rovnakého príznaku nie je prenosné.

Príklady

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

static once_flag initialization_flag = ONCE_FLAG_INIT;
static int initialization_count;
static int shared_value;

static void initialize_shared_value(void) {
    ++initialization_count;
    shared_value = 42;
}

static int worker(void *unused) {
    (void)unused;
    call_once(&initialization_flag, initialize_shared_value);
    return 0;
}

int main(void) {
    thrd_t first;
    thrd_t second;
    if (thrd_create(&first, worker, NULL) != thrd_success) return 1;
    if (thrd_create(&second, worker, NULL) != thrd_success) {
        thrd_join(first, NULL);
        return 1;
    }
    thrd_join(first, NULL);
    thrd_join(second, NULL);
    printf("%d %d\n", initialization_count, shared_value);
    return 0;
}

Výsledok

1 42

Slúži na bezpečnú lenivú inicializáciu zdieľaného stavu. V príklade dve vlákna volajú `call_once`, ale inicializátor zvýši počítadlo iba raz a zverejní `value = 42`; po join je výsledok `1 42`.

Zdroje