Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

call_once — funkcja biblioteki C23

`call_once(flag, func)` używa `once_flag`, aby wywołać `func` dokładnie raz — przy pierwszym skutecznym wywołaniu z tym samym obiektem flagi — i niczego nie zwraca. Zakończenie skutecznego wywołania synchronizuje się ze wszystkimi pozostałymi wywołaniami dla tej flagi: już rozpoczętymi i czekającymi na `func` oraz późniejszymi.

Wersja: C23

Składnia

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

call_once(flag, func) używa once_flag, aby wywołać func dokładnie raz — przy pierwszym skutecznym wywołaniu z tym samym obiektem flagi — i niczego nie zwraca. Zakończenie skutecznego wywołania synchronizuje się ze wszystkimi pozostałymi wywołaniami dla tej flagi: już rozpoczętymi i czekającymi na func oraz późniejszymi.

Służy do bezpiecznej leniwej inicjalizacji współdzielonego stanu. Przykład uruchamia dwa wątki, oba wołają call_once, lecz inicjalizator zwiększa licznik tylko raz i publikuje value = 42; po join wynik to 1 42.

Flaga musi być zainicjalizowana przez ONCE_FLAG_INIT i zachować ten sam obiekt przez cały protokół; nie kopiuj jej ani nie próbuj resetować. func ma typ void(void), a call_once nie zwraca kodu błędu. Implementacja z __STDC_NO_THREADS__ może nie dostarczać <threads.h>, a rekurencyjne użycie tej samej flagi nie jest przenośnym protokołem.

Przykłady

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

Wynik

1 42

Służy do bezpiecznej leniwej inicjalizacji współdzielonego stanu. Przykład uruchamia dwa wątki, oba wołają `call_once`, lecz inicjalizator zwiększa licznik tylko raz i publikuje `value = 42`; po join wynik to `1 42`.

Źródła