Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::atomic_ref: atomske operacije nad postojećim objektom

std::atomic_ref stvara nevlasnički atomski pogled na postojeći trivijalno kopirljiv objekt.

Verzija: C++23

Sintaksa

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> iz <atomic> ne posjeduje vrijednost: veže se uz postojeći T i nad njim izvodi load, store, exchange, compare-exchange i odgovarajuće read-modify-write operacije. Objekt mora nadživjeti sve svoje poglede.

T mora biti trivijalno kopirljiv, a adresa zadovoljiti atomic_ref<T>::required_alignment. Dok pogled postoji, svi pristupi cijelom objektu moraju ići isključivo kroz kompatibilne instance atomic_ref; konkurentno obično čitanje ili pisanje krši ugovor. std::atomic_ref::required_alignment navodi potrebno poravnanje objekta na koji će se pogled odnositi. Za odgovarajuću brojčanu ili pokazivačku specijalizaciju std::atomic_ref::fetch_add atomski pribraja operand kao jednu read-modify-write operaciju i vraća prethodnu vrijednost.

Pogled se može kopirati, ali ne i prevezati pridruživanjem. Operacije ne moraju biti lock-free; provjeri is_lock_free(). Zadano je std::memory_order_seq_cst, a slabiji poretci zahtijevaju ispravan protokol.

Primjeri

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

Rezultat

7

std::atomic_ref → 7

Izvori