Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::atomic_ref: atomické operácie nad existujúcim objektom

std::atomic_ref vytvára nevlastniaci atomický pohľad na existujúci triviálne kopírovateľný objekt.

Verzia: C++23

Syntax

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: naviaže sa na existujúci T a vykonáva nad ním load, store, exchange, compare-exchange a vhodné read-modify-write operácie. Odkazovaný objekt musí prežiť všetky svoje pohľady.

T musí byť triviálne kopírovateľný a adresa musí spĺňať atomic_ref<T>::required_alignment. Kým pohľad existuje, všetky prístupy k celému objektu musia prebiehať výhradne cez kompatibilné inštancie atomic_ref; súbežné bežné čítanie či zápis porušuje kontrakt. std::atomic_ref::required_alignment udáva požadované zarovnanie objektu, na ktorý bude pohľad odkazovať. Pri vhodnej číselnej alebo ukazovateľovej špecializácii std::atomic_ref::fetch_add atómovo pripočíta operand ako jedinú read-modify-write operáciu a vráti predchádzajúcu hodnotu.

Pohľad možno kopírovať, ale priradením ho nemožno previazať. Operácie nemusia byť lock-free; overí to is_lock_free(). Predvolené je std::memory_order_seq_cst, slabšie poradia vyžadujú správny protokol.

Prí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ýsledok

7

std::atomic_ref → 7

Zdroje