CKTIS / C
call_once — bibliotečna funkcija C23
`call_once(flag, func)` koristi `once_flag` da pozove `func` točno jednom, pri prvom učinkovitom pozivu s tim objektom, i ne vraća vrijednost. Završetak se sinkronizira sa svakim drugim pozivom iste zastavice: s već aktivnim pozivateljima koji čekaju `func` i s kasnijima.
Verzija: C23
Sintaksa
void call_once(once_flag *flag, void (*func)(void));call_once(flag, func) koristi once_flag da pozove func točno jednom, pri prvom učinkovitom pozivu s tim objektom, i ne vraća vrijednost. Završetak se sinkronizira sa svakim drugim pozivom iste zastavice: s već aktivnim pozivateljima koji čekaju func i s kasnijima.
Služi sigurnoj lijenoj inicijalizaciji zajedničkog stanja. U primjeru dvije dretve zovu call_once, ali inicijalizator jednom povećava brojač i objavljuje value = 42; nakon join rezultat je 1 42.
Zastavica mora biti inicijalizirana s ONCE_FLAG_INIT i ostati isti objekt; nemoj je kopirati ni resetirati. func ima tip void(void), a call_once ne vraća pogrešku. Implementacija s __STDC_NO_THREADS__ može izostaviti <threads.h>; rekurzivna uporaba iste zastavice nije prenosiva.
Primjeri
#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
Služi sigurnoj lijenoj inicijalizaciji zajedničkog stanja. U primjeru dvije dretve zovu `call_once`, ali inicijalizator jednom povećava brojač i objavljuje `value = 42`; nakon join rezultat je `1 42`.