Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

call_once — función de biblioteca C23

`call_once(flag, func)` usa un `once_flag` para llamar a `func` exactamente una vez, en la primera llamada efectiva con ese objeto, y no devuelve valor. Su finalización sincroniza con todas las demás llamadas de la misma bandera: las ya en curso que esperan a `func` y las posteriores.

Versión: C23

Sintaxis

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

call_once(flag, func) usa un once_flag para llamar a func exactamente una vez, en la primera llamada efectiva con ese objeto, y no devuelve valor. Su finalización sincroniza con todas las demás llamadas de la misma bandera: las ya en curso que esperan a func y las posteriores.

Permite inicialización perezosa segura de estado compartido. En el ejemplo dos hilos llaman a call_once, pero el inicializador incrementa el contador una sola vez y publica value = 42; tras join, el resultado es 1 42.

La bandera debe inicializarse con ONCE_FLAG_INIT y seguir siendo el mismo objeto; no la copies ni intentes reiniciarla. func tiene tipo void(void) y call_once no devuelve errores. Una implementación con __STDC_NO_THREADS__ puede omitir <threads.h>; usar recursivamente la misma bandera no es portable.

Ejemplos

#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

Permite inicialización perezosa segura de estado compartido. En el ejemplo dos hilos llaman a `call_once`, pero el inicializador incrementa el contador una sola vez y publica `value = 42`; tras join, el resultado es `1 42`.

Fuentes