KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

atomic_load — atomaire generieke C23-functie

`atomic_load(object)` retourneert atomair de waarde van het aangewezen atomaire object. De vorm zonder `_explicit` is gelijk aan `atomic_load_explicit(..., memory_order_seq_cst)`; `volatile` op de pointer bewaart apparaatregistersemantiek.

Versie: C23

Syntax

C atomic_load(const volatile A *object);

atomic_load(object) retourneert atomair de waarde van het aangewezen atomaire object. De vorm zonder _explicit is gelijk aan atomic_load_explicit(..., memory_order_seq_cst); volatile op de pointer bewaart apparaatregistersemantiek.

Een load levert een coherent momentbeeld van een teller of vlag zonder race met atomaire schrijvers. Het voorbeeld verhoogt 41 naar 42; daarna retourneren de echte sequentieel consistente en relaxed loads beide 42.

atomic_load_explicit mag geen memory_order_release of memory_order_acq_rel gebruiken; relaxed garandeert nog atomiciteit en de modificatievolgorde van het object, maar publiceert geen andere data. Object en pointer moeten geldig zijn; de bewerking hoeft niet lock-free te zijn.

De naam van deze generieke functie kan een macro of een externe identifier zijn; de macro onderdrukken om een echte functie aan te roepen, of een externe identifier met die naam definiëren, heeft ongedefinieerd gedrag.

Voorbeelden

#include <stdatomic.h>
#include <stdio.h>

int main(void) {
    atomic_int counter = 41;
    atomic_fetch_add(&counter, 1);
    int sequential = atomic_load(&counter);
    int relaxed = atomic_load_explicit(&counter, memory_order_relaxed);
    printf("%d %d\n", sequential, relaxed);
    return 0;
}

Resultaat

42 42

Een load levert een coherent momentbeeld van een teller of vlag zonder race met atomaire schrijvers. Het voorbeeld verhoogt `41` naar `42`; daarna retourneren de echte sequentieel consistente en relaxed loads beide `42`.

Bronnen