CKTIS / C++
std::atomic_ref: atomare Operationen auf einem vorhandenen Objekt
std::atomic_ref erzeugt eine nicht besitzende atomare Sicht auf ein vorhandenes trivial kopierbares Objekt.
Version: C++23
Syntax
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> aus <atomic> besitzt keinen Wert, sondern bindet sich an ein vorhandenes T und führt darauf load, store, exchange, Compare-exchange und passende Read-modify-write-Operationen aus. Das referenzierte Objekt muss alle Sichten überleben.
T muss trivial kopierbar sein und die Adresse atomic_ref<T>::required_alignment erfüllen. Solange eine solche Sicht existiert, dürfen alle Zugriffe auf das vollständige Objekt ausschließlich über kompatible atomic_ref-Instanzen erfolgen; ein konkurrierender normaler Lese- oder Schreibzugriff verletzt den Vertrag. std::atomic_ref::required_alignment gibt die erforderliche Ausrichtung des Objekts an, auf das die Sicht verweist. Bei einer passenden Zahlen- oder Zeigerspezialisierung addiert std::atomic_ref::fetch_add den Operanden atomar als eine Read-modify-write-Operation und liefert den vorherigen Wert.
Die Sicht ist kopierbar, kann aber per Zuweisung nicht neu gebunden werden. Operationen müssen nicht lock-free sein; dafür dient is_lock_free(). Standard ist std::memory_order_seq_cst, schwächere Ordnungen brauchen ein korrektes Synchronisationsprotokoll.
Beispiele
#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';
}
Ergebnis
7
std::atomic_ref → 7