Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

call_once — função de biblioteca C23

`call_once(flag, func)` usa um `once_flag` para chamar `func` exatamente uma vez, na primeira chamada efetiva com esse objeto, e não devolve valor. A conclusão sincroniza com todas as outras chamadas da mesma flag: as já em curso à espera de `func` e as posteriores.

Versão: C23

Sintaxe

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

call_once(flag, func) usa um once_flag para chamar func exatamente uma vez, na primeira chamada efetiva com esse objeto, e não devolve valor. A conclusão sincroniza com todas as outras chamadas da mesma flag: as já em curso à espera de func e as posteriores.

Serve para inicialização tardia segura de estado partilhado. No exemplo, duas threads chamam call_once, mas o inicializador incrementa o contador uma vez e publica value = 42; após join, o resultado é 1 42.

A flag tem de ser inicializada com ONCE_FLAG_INIT e continuar o mesmo objeto; não a copies nem tentes repor. func tem tipo void(void) e call_once não devolve erros. Uma implementação com __STDC_NO_THREADS__ pode omitir <threads.h>; usar recursivamente a mesma flag não é portável.

Exemplos

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

Resultado

1 42

Serve para inicialização tardia segura de estado partilhado. No exemplo, duas threads chamam `call_once`, mas o inicializador incrementa o contador uma vez e publica `value = 42`; após join, o resultado é `1 42`.

Fontes