std::atomic_store, std::atomic_store_explicit

< cpp‎ | atomic
在标头 <atomic> 定义
template< class T >

void atomic_store( std::atomic<T>* obj,

                   typename std::atomic<T>::value_type desired ) noexcept;
 (1) (C++11 起)
template< class T >

void atomic_store( volatile std::atomic<T>* obj,

                   typename std::atomic<T>::value_type desired ) noexcept;
 (2) (C++11 起)
template< class T >

void atomic_store_explicit( std::atomic<T>* obj,
                            typename std::atomic<T>::value_type desired,

                            std::memory_order order) noexcept;
 (3) (C++11 起)
template< class T >

void atomic_store_explicit( volatile std::atomic<T>* obj,
                            typename std::atomic<T>::value_type desired,

                            std::memory_order order) noexcept;
 (4) (C++11 起)
1,2) 如同用 obj->store(desired) 以 desired 的值原子地替换 obj 指向的值。
3,4) 如同用 obj->store(desired, order) 以 desired 的值原子地替换 obj 指向的值。
如果 order 是 std::memory_order_consume、std::memory_order_acquire 和 std::memory_order_acq_rel 之一，那么行为未定义。

参数

obj - 指向要修改的原子对象的指针
desired - 要存储到原子对象的值
order - 内存同步定序

返回值

（无）

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告 应用于 出版时的行为 正确行为
P0558R1 C++11 要求准确类型匹配，因为会从多个实参推导 T 只会从 obj 推导 T

参阅

 原子地以非原子实参替换原子对象的值
(std::atomic<T> 的公开成员函数)
(C++11)(C++11)
 原子地获得存储于原子对象的值
(函数模板)
(C++11)
 为给定的原子操作定义内存定序约束
(枚举)
(C++20 中弃用)(C++26 中移除)
 为 std::shared_ptr 特化原子操作
(函数模板)