WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

atomic_store — atomare generische C23-Funktion

`atomic_store(object, desired)` ersetzt den Wert des angegebenen atomaren Objekts atomar durch `desired` und liefert nichts. Die Form ohne `_explicit` nutzt `memory_order_seq_cst`; dies ist ein Schreibzugriff, keine Read-Modify-Write-Operation.

Version: C23

Syntax

void atomic_store(volatile A *object, C desired);

atomic_store(object, desired) ersetzt den Wert des angegebenen atomaren Objekts atomar durch desired und liefert nichts. Die Form ohne _explicit nutzt memory_order_seq_cst; dies ist ein Schreibzugriff, keine Read-Modify-Write-Operation.

Ein Release-Store veröffentlicht fertigen Zustand, den ein Verbraucher per Acquire-Load vom selben Atom liest. Das Beispiel speichert 17 und dann 23; der echte Acquire-Load beobachtet den Endwert 23.

atomic_store_explicit darf memory_order_consume, memory_order_acquire und memory_order_acq_rel nicht erhalten; relaxed schreibt atomar, veröffentlicht aber keine vorherigen gewöhnlichen Schreibzugriffe. Objekt und Zeiger müssen gültig sein; die Implementierung darf eine Sperre verwenden.

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 state = 0;
    atomic_store(&state, 17);
    atomic_store_explicit(&state, 23, memory_order_release);
    printf("%d\n", atomic_load_explicit(&state, memory_order_acquire));
    return 0;
}

Ergebnis

23

Ein Release-Store veröffentlicht fertigen Zustand, den ein Verbraucher per Acquire-Load vom selben Atom liest. Das Beispiel speichert `17` und dann `23`; der echte Acquire-Load beobachtet den Endwert `23`.

Quellen