WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

call_once — C23-Bibliotheksfunktion

`call_once(flag, func)` verwendet ein `once_flag`, um `func` genau einmal beim ersten wirksamen Aufruf mit diesem Flagobjekt aufzurufen, und liefert nichts. Dessen Abschluss synchronisiert mit jedem anderen Aufruf für dasselbe Flag: bereits laufenden, auf `func` wartenden sowie späteren Aufrufen.

Version: C23

Syntax

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

call_once(flag, func) verwendet ein once_flag, um func genau einmal beim ersten wirksamen Aufruf mit diesem Flagobjekt aufzurufen, und liefert nichts. Dessen Abschluss synchronisiert mit jedem anderen Aufruf für dasselbe Flag: bereits laufenden, auf func wartenden sowie späteren Aufrufen.

Damit lässt sich gemeinsamer Zustand sicher verzögert initialisieren. Im Beispiel rufen zwei Threads call_once auf, doch der Initialisierer erhöht seinen Zähler nur einmal und veröffentlicht value = 42; nach Join lautet das Ergebnis 1 42.

Das Flag muss mit ONCE_FLAG_INIT initialisiert sein und während des Protokolls dasselbe Objekt bleiben; nicht kopieren oder zurücksetzen. func hat den Typ void(void), und call_once liefert keinen Fehlercode. Bei __STDC_NO_THREADS__ darf <threads.h> fehlen; rekursiver Einsatz desselben Flags ist kein portables Protokoll.

Beispiele

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

Ergebnis

1 42

Damit lässt sich gemeinsamer Zustand sicher verzögert initialisieren. Im Beispiel rufen zwei Threads `call_once` auf, doch der Initialisierer erhöht seinen Zähler nur einmal und veröffentlicht `value = 42`; nach Join lautet das Ergebnis `1 42`.

Quellen