CKTIS / C++
std::atomic_ref: atomické operace nad existujícím objektem
std::atomic_ref vytváří nevlastnící atomický pohled na existující triviálně kopírovatelný objekt.
Verze: C++23
Syntaxe
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> nevlastní hodnotu: naváže se na existující T a provádí nad ním load, store, exchange, compare-exchange a vhodné read-modify-write operace. Odkazovaný objekt musí přežít všechny své pohledy.
T musí být triviálně kopírovatelný a adresa musí splnit atomic_ref<T>::required_alignment. Dokud pohled existuje, musí všechny přístupy k celému objektu probíhat výhradně přes kompatibilní instance atomic_ref; souběžné běžné čtení či zápis porušuje kontrakt. std::atomic_ref::required_alignment udává požadované zarovnání objektu, na který bude pohled odkazovat. U vhodné číselné nebo ukazatelové specializace std::atomic_ref::fetch_add atomicky přičte operand jako jedinou read-modify-write operaci a vrátí předchozí hodnotu.
Pohled lze kopírovat, ale přiřazením jej nelze přenavázat. Operace nemusí být lock-free; ověří to is_lock_free(). Výchozí je std::memory_order_seq_cst, slabší pořadí vyžadují správný protokol.
Příklady
#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';
}
Výsledek
7
std::atomic_ref → 7