KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

call_once — C23-bibliotheekfunctie

`call_once(flag, func)` gebruikt een `once_flag` om `func` precies eenmaal bij de eerste effectieve aanroep met dat object uit te voeren en retourneert niets. Voltooiing synchroniseert met elke andere aanroep voor dezelfde vlag: al lopende aanroepers die op `func` wachten en latere aanroepers.

Versie: C23

Syntax

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

call_once(flag, func) gebruikt een once_flag om func precies eenmaal bij de eerste effectieve aanroep met dat object uit te voeren en retourneert niets. Voltooiing synchroniseert met elke andere aanroep voor dezelfde vlag: al lopende aanroepers die op func wachten en latere aanroepers.

Gebruik dit voor veilige luie initialisatie van gedeelde toestand. In het voorbeeld roepen twee threads call_once aan, maar de initializer verhoogt de teller eenmaal en publiceert value = 42; na join is het resultaat 1 42.

De vlag moet met ONCE_FLAG_INIT zijn geïnitialiseerd en hetzelfde object blijven; kopieer of reset hem niet. func heeft type void(void) en call_once retourneert geen foutcode. Een implementatie met __STDC_NO_THREADS__ mag <threads.h> weglaten; recursief gebruik van dezelfde vlag is niet overdraagbaar.

Voorbeelden

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

Resultaat

1 42

Gebruik dit voor veilige luie initialisatie van gedeelde toestand. In het voorbeeld roepen twee threads `call_once` aan, maar de initializer verhoogt de teller eenmaal en publiceert `value = 42`; na join is het resultaat `1 42`.

Bronnen