База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

call_once — библиотечна функция на C23

`call_once(flag, func)` използва `once_flag`, за да извика `func` точно веднъж при първото ефективно извикване с този обект, и не връща стойност. Завършването се синхронизира с всяко друго извикване за същия флаг: с вече започналите и чакащи `func`, както и с по-късните.

Версия: C23

Синтаксис

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

call_once(flag, func) използва once_flag, за да извика func точно веднъж при първото ефективно извикване с този обект, и не връща стойност. Завършването се синхронизира с всяко друго извикване за същия флаг: с вече започналите и чакащи func, както и с по-късните.

Служи за безопасна мързелива инициализация на споделено състояние. В примера две нишки викат call_once, но инициализаторът увеличава брояча веднъж и публикува value = 42; след join резултатът е 1 42.

Флагът трябва да е инициализиран с ONCE_FLAG_INIT и да остане същият обект; не го копирайте и не го нулирайте. func е от тип void(void), а call_once не връща грешка. Реализация с __STDC_NO_THREADS__ може да няма <threads.h>; рекурсивната употреба на същия флаг не е преносима.

Примери

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

Резултат

1 42

Служи за безопасна мързелива инициализация на споделено състояние. В примера две нишки викат `call_once`, но инициализаторът увеличава брояча веднъж и публикува `value = 42`; след join резултатът е `1 42`.

Източници