CKTIS / C++
std::atomic_ref: atomaire bewerkingen op een bestaand object
std::atomic_ref maakt een niet-bezittende atomaire view van een bestaand triviaal kopieerbaar object.
Versie: 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> uit <atomic> bezit geen waarde: het bindt aan een bestaand T en voert daarop load, store, exchange, compare-exchange en passende read-modify-write-bewerkingen uit. Het gerefereerde object moet alle views overleven.
T moet triviaal kopieerbaar zijn en het adres moet voldoen aan atomic_ref<T>::required_alignment. Zolang zo’n view bestaat, moet elke toegang tot het volledige object uitsluitend via compatibele atomic_ref-instanties verlopen; een gelijktijdige gewone lees- of schrijfactie schendt het contract. std::atomic_ref::required_alignment geeft de vereiste uitlijning van het object waarnaar de view zal verwijzen. Bij een toepasselijke numerieke of pointerspecialisatie telt std::atomic_ref::fetch_add de operand atomair op als één read-modify-write-bewerking en retourneert de vorige waarde.
De view is kopieerbaar maar niet via toewijzing opnieuw te binden. Bewerkingen zijn niet noodzakelijk lock-free; controleer is_lock_free(). Standaard geldt std::memory_order_seq_cst; zwakkere ordeningen vereisen een correct protocol.
Voorbeelden
#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';
}
Resultaat
7
std::atomic_ref → 7