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

CKTIS / C

call_once — knjižnična funkcija C23

`call_once(flag, func)` uporabi `once_flag`, da `func` pokliče natanko enkrat ob prvem učinkovitem klicu s tem objektom, in ne vrne ničesar. Dokončanje se sinhronizira z vsakim drugim klicem iste zastavice: z že tekočimi klicatelji, ki čakajo na `func`, in s poznejšimi.

Različica: C23

Sintaksa

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

call_once(flag, func) uporabi once_flag, da func pokliče natanko enkrat ob prvem učinkovitem klicu s tem objektom, in ne vrne ničesar. Dokončanje se sinhronizira z vsakim drugim klicem iste zastavice: z že tekočimi klicatelji, ki čakajo na func, in s poznejšimi.

Primerna je za varno leno inicializacijo skupnega stanja. V primeru dve niti kličeta call_once, inicializator pa števec poveča le enkrat in objavi value = 42; po join je rezultat 1 42.

Zastavica mora biti inicializirana z ONCE_FLAG_INIT in ostati isti objekt; ne kopirajte in ne ponastavljajte je. func ima tip void(void), call_once pa ne vrne napake. Izvedba z __STDC_NO_THREADS__ lahko izpusti <threads.h>; rekurzivna uporaba iste zastavice ni prenosljiva.

Primeri

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

Rezultat

1 42

Primerna je za varno leno inicializacijo skupnega stanja. V primeru dve niti kličeta `call_once`, inicializator pa števec poveča le enkrat in objavi `value = 42`; po join je rezultat `1 42`.

Viri