CKTIS / C++
std::atomic_ref: operações atómicas num objeto existente
std::atomic_ref cria uma vista atómica não proprietária de um objeto existente trivialmente copiável.
Versão: C++23
Sintaxe
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>, de <atomic>, não possui um valor: liga-se a um T existente e executa load, store, exchange, compare-exchange e operações read-modify-write adequadas. O objeto referido deve sobreviver a todas as vistas.
T tem de ser trivialmente copiável e o endereço cumprir atomic_ref<T>::required_alignment. Enquanto existir uma vista, todos os acessos ao objeto completo têm de ocorrer exclusivamente por instâncias atomic_ref compatíveis; uma leitura ou escrita normal concorrente viola o contrato. std::atomic_ref::required_alignment indica o alinhamento exigido ao objeto que a vista vai referir. Numa especialização numérica ou de ponteiro aplicável, std::atomic_ref::fetch_add soma atomicamente o operando como uma operação read-modify-write e devolve o valor anterior.
A vista pode ser copiada, mas não religada por atribuição. As operações podem não ser lock-free; usa is_lock_free(). A ordem predefinida é std::memory_order_seq_cst; ordens mais fracas exigem um protocolo correto.
Exemplos
#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';
}
Resultado
7
std::atomic_ref → 7