CKTIS / C++
std::atomic_ref: atomické operácie nad existujúcim objektom
std::atomic_ref vytvára nevlastniaci atomický pohľad na existujúci triviálne kopírovateľný objekt.
Verzia: 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> z <atomic> nevlastní hodnotu: naviaže sa na existujúci T a vykonáva nad ním load, store, exchange, compare-exchange a vhodné read-modify-write operácie. Odkazovaný objekt musí prežiť všetky svoje pohľady.
T musí byť triviálne kopírovateľný a adresa musí spĺňať atomic_ref<T>::required_alignment. Kým pohľad existuje, všetky prístupy k celému objektu musia prebiehať výhradne cez kompatibilné inštancie atomic_ref; súbežné bežné čítanie či zápis porušuje kontrakt. std::atomic_ref::required_alignment udáva požadované zarovnanie objektu, na ktorý bude pohľad odkazovať. Pri vhodnej číselnej alebo ukazovateľovej špecializácii std::atomic_ref::fetch_add atómovo pripočíta operand ako jedinú read-modify-write operáciu a vráti predchádzajúcu hodnotu.
Pohľad možno kopírovať, ale priradením ho nemožno previazať. Operácie nemusia byť lock-free; overí to is_lock_free(). Predvolené je std::memory_order_seq_cst, slabšie poradia vyžadujú správny protokol.
Prí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ýsledok
7
std::atomic_ref → 7