CKTIS / C
call_once — knihovní funkce C23
`call_once(flag, func)` použije `once_flag`, aby zavolala `func` právě jednou při prvním účinném volání s tímto objektem, a nic nevrací. Dokončení se synchronizuje s každým dalším voláním stejného příznaku: s již probíhajícími volajícími čekajícími na `func` i s pozdějšími.
Verze: C23
Syntaxe
void call_once(once_flag *flag, void (*func)(void));call_once(flag, func) použije once_flag, aby zavolala func právě jednou při prvním účinném volání s tímto objektem, a nic nevrací. Dokončení se synchronizuje s každým dalším voláním stejného příznaku: s již probíhajícími volajícími čekajícími na func i s pozdějšími.
Slouží k bezpečné líné inicializaci sdíleného stavu. V příkladu dvě vlákna volají call_once, ale inicializátor zvýší čítač jen jednou a zveřejní value = 42; po join je výsledek 1 42.
Příznak musí být inicializován ONCE_FLAG_INIT a zůstat týmž objektem; nekopírujte jej ani neresetujte. func má typ void(void) a call_once nevrací chybu. Implementace s __STDC_NO_THREADS__ může vynechat <threads.h>; rekurzivní použití stejného příznaku není přenosné.
Příklady
#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;
}
Výsledek
1 42
Slouží k bezpečné líné inicializaci sdíleného stavu. V příkladu dvě vlákna volají `call_once`, ale inicializátor zvýší čítač jen jednou a zveřejní `value = 42`; po join je výsledek `1 42`.