Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::atomic_ref: operazioni atomiche su un oggetto esistente

std::atomic_ref crea una vista atomica non proprietaria di un oggetto esistente banalmente copiabile.

Versione: C++23

Sintassi

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> di <atomic> non possiede un valore: si lega a un T esistente ed esegue load, store, exchange, compare-exchange e opportune operazioni read-modify-write. L’oggetto riferito deve vivere più a lungo di tutte le viste.

T deve essere banalmente copiabile e l’indirizzo rispettare atomic_ref<T>::required_alignment. Finché esiste una vista, ogni accesso all’oggetto completo deve avvenire esclusivamente tramite istanze atomic_ref compatibili; una lettura o scrittura ordinaria concorrente viola il contratto. std::atomic_ref::required_alignment indica l’allineamento richiesto all’oggetto cui si riferirà la vista. In una specializzazione numerica o per puntatori applicabile, std::atomic_ref::fetch_add aggiunge atomicamente l’operando come un’unica operazione read-modify-write e restituisce il valore precedente.

La vista è copiabile ma non ricollegabile tramite assegnazione. Le operazioni non sono necessariamente lock-free; usa is_lock_free(). L’ordine predefinito è std::memory_order_seq_cst; ordini più deboli richiedono un protocollo corretto.

Esempi

#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';
}

Risultato

7

std::atomic_ref → 7

Fonti