Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

call_once — funzione di libreria C23

`call_once(flag, func)` usa un `once_flag` per chiamare `func` esattamente una volta, alla prima chiamata effettiva con quell’oggetto, e non restituisce valori. Il completamento sincronizza con ogni altra chiamata sulla stessa flag: quelle già in corso e in attesa di `func`, oltre alle successive.

Versione: C23

Sintassi

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

call_once(flag, func) usa un once_flag per chiamare func esattamente una volta, alla prima chiamata effettiva con quell’oggetto, e non restituisce valori. Il completamento sincronizza con ogni altra chiamata sulla stessa flag: quelle già in corso e in attesa di func, oltre alle successive.

Serve all’inizializzazione pigra sicura di stato condiviso. Nell’esempio due thread chiamano call_once, ma l’inizializzatore incrementa il contatore una volta e pubblica value = 42; dopo i join il risultato è 1 42.

La flag va inizializzata con ONCE_FLAG_INIT e deve restare lo stesso oggetto; non copiarla né reimpostarla. func ha tipo void(void) e call_once non restituisce errori. Un’implementazione con __STDC_NO_THREADS__ può omettere <threads.h>; l’uso ricorsivo della stessa flag non è portabile.

Esempi

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

Risultato

1 42

Serve all’inizializzazione pigra sicura di stato condiviso. Nell’esempio due thread chiamano `call_once`, ma l’inizializzatore incrementa il contatore una volta e pubblica `value = 42`; dopo i join il risultato è `1 42`.

Fonti