CKTIS / C
atomic_load — atomare generische C23-Funktion
`atomic_load(object)` liefert atomar den Wert des angegebenen atomaren Objekts. Die Form ohne `_explicit` entspricht `atomic_load_explicit(..., memory_order_seq_cst)`; die `volatile`-Qualifikation des Zeigers bewahrt Geräteregister-Semantik.
Version: C23
Syntax
C atomic_load(const volatile A *object);atomic_load(object) liefert atomar den Wert des angegebenen atomaren Objekts. Die Form ohne _explicit entspricht atomic_load_explicit(..., memory_order_seq_cst); die volatile-Qualifikation des Zeigers bewahrt Geräteregister-Semantik.
Ein Load liest einen konsistenten Schnappschuss eines Zählers oder Flags ohne Rennen mit atomaren Schreibern. Das Beispiel erhöht von 41 auf 42; danach liefern sowohl der sequentiell konsistente als auch der relaxed Load wirklich 42.
atomic_load_explicit darf weder memory_order_release noch memory_order_acq_rel verwenden; relaxed garantiert weiter Atomarität und Modifikationsreihenfolge des Objekts, veröffentlicht aber keine anderen Daten. Objekt und Zeiger müssen gültig sein; die Operation muss nicht lock-free sein.
Der Name dieser generischen Funktion darf ein Makro oder ein externer Bezeichner sein; das Unterdrücken des Makros zum Aufruf einer tatsächlichen Funktion oder das Definieren eines externen Bezeichners dieses Namens hat undefiniertes Verhalten.
Beispiele
#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;
}
Ergebnis
42 42
Ein Load liest einen konsistenten Schnappschuss eines Zählers oder Flags ohne Rennen mit atomaren Schreibern. Das Beispiel erhöht von `41` auf `42`; danach liefern sowohl der sequentiell konsistente als auch der relaxed Load wirklich `42`.