База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::atomic_ref: атомарни операции върху съществуващ обект

std::atomic_ref създава непритежаващ атомарен изглед към съществуващ тривиално копируем обект.

Версия: C++23

Синтаксис

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> от <atomic> не притежава стойност: свързва се със съществуващ T и изпълнява load, store, exchange, compare-exchange и подходящи read-modify-write операции. Обектът трябва да живее по-дълго от всички изгледи към него.

T трябва да е тривиално копируем, а адресът да удовлетворява atomic_ref<T>::required_alignment. Докато има такъв изглед, всички достъпи до целия обект трябва да стават само през съвместими atomic_ref; конкурентно обикновено четене или запис нарушава договора. std::atomic_ref::required_alignment задава изискваното подравняване на обекта, към който ще сочи изгледът. При приложима числова или указателна специализация std::atomic_ref::fetch_add атомарно добавя операнда като една read-modify-write операция и връща предишната стойност.

Изгледът може да се копира, но не и да се пренасочи чрез присвояване. Операциите може да не са lock-free; провери is_lock_free(). По подразбиране е std::memory_order_seq_cst, а по-слабите редове изискват правилен протокол.

Примери

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

Резултат

7

std::atomic_ref → 7

Източници