Namespaces
Variants

std:: atomic_store, std:: atomic_store_explicit

From cppreference.net
C++
Concurrency support library
Threads
(C++11)
(C++20)
(C++17) (C++17)
this_thread namespace
(C++11)
(C++11)
Cooperative cancellation
Mutual exclusion
Generic lock management
Condition variables
(C++11)
(C++11)
(C++11)
(C++11)
Semaphores
(C++20) (C++20)
Latches and Barriers
(C++20)
(C++20)
Futures
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Safe reclamation
Hazard pointers
(C++26)
(C++26)
(C++26)
Atomic types
(C++11)
(C++20)
(C++11)
Initialization of atomic types
(C++11) (deprecated in C++20)
(C++11) (deprecated in C++20)
(C++11)
Memory ordering
(C++11)
(C++11) (deprecated in C++26)
(C++11)
(C++11)
Free functions for atomic operations
atomic_store atomic_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)
Free functions for atomic flags
(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 所指向的值替换为 desired 的值，操作方式等同于执行 obj - > store ( desired ) 。
3,4) 以原子操作将 obj 所指向的值替换为 desired 的值，操作效果等同于执行 obj - > store ( desired, order ) 。
如果 order 是 std:: memory_order_consume 、 std:: memory_order_acquire 或 std:: memory_order_acq_rel 之一，则行为未定义。

目录

参数

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

返回值

(无)

缺陷报告

下列行为变更缺陷报告被追溯应用于先前发布的 C++ 标准。

DR 适用范围 发布时的行为 正确行为
P0558R1 C++11 由于
T 是从多个参数推导得出，因此需要精确类型匹配 		T 仅从
obj 推导

参见

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