Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::atomic_ref: operaciones atómicas sobre un objeto existente

std::atomic_ref crea una vista atómica no propietaria de un objeto existente trivialmente copiable.

Versión: C++23

Sintaxis

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>, no posee un valor: se enlaza a un T existente y realiza load, store, exchange, compare-exchange y operaciones read-modify-write adecuadas. El objeto referido debe sobrevivir a todas sus vistas.

T debe ser trivialmente copiable y la dirección cumplir atomic_ref<T>::required_alignment. Mientras exista una vista, todos los accesos al objeto completo deben hacerse exclusivamente mediante instancias atomic_ref compatibles; una lectura o escritura ordinaria concurrente incumple el contrato. std::atomic_ref::required_alignment indica la alineación exigida al objeto que referirá la vista. En una especialización numérica o de puntero aplicable, std::atomic_ref::fetch_add suma atómicamente su operando como una operación read-modify-write y devuelve el valor anterior.

La vista se puede copiar, pero no reenlazar por asignación. Las operaciones no tienen que ser lock-free; usa is_lock_free(). El orden predeterminado es std::memory_order_seq_cst; órdenes más débiles requieren un protocolo correcto.

Ejemplos

#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

Fuentes