CKTIS / C++
std::atomic_ref: atomowe operacje na istniejącym obiekcie
std::atomic_ref tworzy nieposiadający widok atomowy na istniejący obiekt typu trywialnie kopiowalnego.
Wersja: C++23
Składnia
template<class T>
struct atomic_ref;
static constexpr std::size_t required_alignment = implementation-defined;
explicit atomic_ref(T& object);
T load(std::memory_order order = std::memory_order_seq_cst) const noexcept;
void store(T desired, std::memory_order order = std::memory_order_seq_cst) const noexcept;
// applicable numeric and pointer specializations additionally provide:
T fetch_add(/* difference type */ operand,
std::memory_order order = std::memory_order_seq_cst) const noexcept;std::atomic_ref<T> z <atomic> nie przechowuje własnej wartości: wiąże się z istniejącym obiektem T i wykonuje na nim load, store, exchange, compare-exchange oraz, dla odpowiednich typów, operacje read-modify-write. Obiekt wskazywany musi żyć dłużej niż wszystkie odnoszące się do niego widoki.
T musi być trywialnie kopiowalny, a adres obiektu spełniać atomic_ref<T>::required_alignment. Gdy istnieje choć jeden taki widok, wszystkie dostępy do całego obiektu muszą odbywać się wyłącznie przez zgodne instancje atomic_ref; konkurencyjny zwykły odczyt lub zapis łamie kontrakt. std::atomic_ref::required_alignment podaje wymagane wyrównanie obiektu, do którego ma się odwoływać widok. W odpowiedniej specjalizacji liczbowej lub wskaźnikowej std::atomic_ref::fetch_add atomowo dodaje argument jako jedną operację read-modify-write i zwraca wcześniejszą wartość.
Widok można kopiować, ale nie można go przepiąć przez operator przypisania. Operacje nie muszą być lock-free; sprawdza to is_lock_free(). Domyślnym porządkiem pamięci jest std::memory_order_seq_cst, a słabsze porządki wymagają poprawnego protokołu synchronizacji.
Przykłady
#include <atomic>
#include <iostream>
int main() {
alignas(std::atomic_ref<int>::required_alignment) int value = 3;
std::atomic_ref<int> view{value};
view.fetch_add(4);
std::cout << view.load() << '\n';
}
Wynik
7
std::atomic_ref → 7