Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła