std::atomic_store, std::atomic_store_explicit

来自cppreference.com
< cpp‎ | atomic
 
C++
 
并发支持库
线程
(C++11)
(C++20)
(C++20)
(C++20)
(C++20)
(C++17)(C++17)
this_thread 命名空间
(C++11)
(C++11)
(C++11)
(C++11)
互斥
(C++11)
(C++11)  
(C++17)
通用锁管理
(C++11)
(C++11)
(C++17)
(C++11)
(C++14)
(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)
条件变量
(C++11)
(C++11)
(C++11)
(C++11)
信号量
(C++20)(C++20)
闩与屏障
(C++20)
(C++20)
未来体
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
安全回收
(C++26)
(C++26)
(C++26)  
(C++26)
(C++26)
(C++26)
风险指针
(C++26)
(C++26)
(C++26)





原子类型
(C++11)
(C++20)
(C++11)
原子类型的初始化
(C++11)(C++20 中弃用)
(C++11)(C++20 中弃用)
(C++11)
内存定序
(C++11)
(C++11)
(C++11)
(C++11)
原子操作的自由函数
atomic_storeatomic_store_explicit
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++26)(C++26)
(C++26)(C++26)
(C++11)
(C++20)(C++20)
(C++20)
(C++20)
原子标志的自由函数
(C++11)(C++11)
(C++11)(C++11)
(C++20)(C++20)
(C++20)(C++20)
(C++20)
(C++20)
 
在标头 <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 特化原子操作
(函数模板)
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/atomic/atomic_store&oldid=90681”