Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::atomic_ref: atomické operace nad existujícím objektem

std::atomic_ref vytváří nevlastnící atomický pohled na existující triviálně kopírovatelný objekt.

Verze: C++23

Syntaxe

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> z <atomic> nevlastní hodnotu: naváže se na existující T a provádí nad ním load, store, exchange, compare-exchange a vhodné read-modify-write operace. Odkazovaný objekt musí přežít všechny své pohledy.

T musí být triviálně kopírovatelný a adresa musí splnit atomic_ref<T>::required_alignment. Dokud pohled existuje, musí všechny přístupy k celému objektu probíhat výhradně přes kompatibilní instance atomic_ref; souběžné běžné čtení či zápis porušuje kontrakt. std::atomic_ref::required_alignment udává požadované zarovnání objektu, na který bude pohled odkazovat. U vhodné číselné nebo ukazatelové specializace std::atomic_ref::fetch_add atomicky přičte operand jako jedinou read-modify-write operaci a vrátí předchozí hodnotu.

Pohled lze kopírovat, ale přiřazením jej nelze přenavázat. Operace nemusí být lock-free; ověří to is_lock_free(). Výchozí je std::memory_order_seq_cst, slabší pořadí vyžadují správný protokol.

Příklady

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

Výsledek

7

std::atomic_ref → 7

Zdroje