CKTIS / C
atomic_store — atomowa funkcja generyczna C23
`atomic_store(object, desired)` atomowo zastępuje wartość wskazanego obiektu przez `desired` i niczego nie zwraca. Wariant bez `_explicit` używa `memory_order_seq_cst`; jest to zapis, a nie operacja read-modify-write.
Wersja: C23
Składnia
void atomic_store(volatile A *object, C desired);atomic_store(object, desired) atomowo zastępuje wartość wskazanego obiektu przez desired i niczego nie zwraca. Wariant bez _explicit używa memory_order_seq_cst; jest to zapis, a nie operacja read-modify-write.
Stosuj store release do publikacji gotowego stanu, który odbiorca odczyta load acquire z tego samego atomu. Przykład zapisuje kolejno 17 i 23, a rzeczywisty odczyt acquire obserwuje końcową wartość 23.
atomic_store_explicit nie może otrzymać memory_order_consume, memory_order_acquire ani memory_order_acq_rel; relaxed zapisuje atomowo, lecz nie publikuje wcześniejszych zwykłych zapisów. Obiekt musi być zainicjalizowany i wskaźnik ważny; operacja może korzystać z blokady implementacji.
Nazwa tej funkcji generycznej może być makrem albo identyfikatorem zewnętrznym; stłumienie makra w celu wywołania rzeczywistej funkcji lub zdefiniowanie zewnętrznego identyfikatora o tej nazwie ma niezdefiniowane zachowanie.
Przykłady
#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;
}
Wynik
23
Stosuj store release do publikacji gotowego stanu, który odbiorca odczyta load acquire z tego samego atomu. Przykład zapisuje kolejno `17` i `23`, a rzeczywisty odczyt acquire obserwuje końcową wartość `23`.