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`.