WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen