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