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`.