CKTIS / C
atomic_load — atomowa funkcja generyczna C23
`atomic_load(object)` atomowo zwraca wartość wskazanego obiektu atomowego. Wariant bez `_explicit` odpowiada `atomic_load_explicit(..., memory_order_seq_cst)`; kwalifikator `volatile` wskaźnika zachowuje semantykę rejestrów urządzeń.
Wersja: C23
Składnia
C atomic_load(const volatile A *object);atomic_load(object) atomowo zwraca wartość wskazanego obiektu atomowego. Wariant bez _explicit odpowiada atomic_load_explicit(..., memory_order_seq_cst); kwalifikator volatile wskaźnika zachowuje semantykę rejestrów urządzeń.
Używaj odczytu do pobrania spójnego obrazu licznika lub flagi bez wyścigu z atomowymi zapisami. Przykład zwiększa licznik z 41 do 42, po czym oba rzeczywiste odczyty — sekwencyjnie spójny i relaxed — zwracają 42.
Dla atomic_load_explicit niedozwolone są memory_order_release i memory_order_acq_rel; relaxed gwarantuje atomowość i kolejność modyfikacji obiektu, ale nie publikuje innych danych. Obiekt musi być poprawnie zainicjalizowany, a wskaźnik ważny; operacja nie musi być lock-free.
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 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;
}
Wynik
42 42
Używaj odczytu do pobrania spójnego obrazu licznika lub flagi bez wyścigu z atomowymi zapisami. Przykład zwiększa licznik z `41` do `42`, po czym oba rzeczywiste odczyty — sekwencyjnie spójny i relaxed — zwracają `42`.