std::atomic_init

< cpp‎ | atomic
 
 
 
定义于头文件 <atomic>
template< class T >

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

                  typename std::atomic<T>::value_type desired ) noexcept;
(C++11 起)
(C++20 中弃用)
template< class T >

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

                  typename std::atomic<T>::value_type desired ) noexcept;
(C++11 起)
(C++20 中弃用)

以值 desired 初始化默认构造的原子对象 obj 。函数非原子:来自其他线程的并发访问,即使通过原子操作,也是数据竞争。

obj 不是默认构造的,则行为未定义。

若在同一 obj 上调用函数二次,则行为未定义。

参数

obj - 指向要初始化的原子对象的指针
desired - 用以初始化原子对象的值

返回值

(无)

注解

为与 C 兼容提供此函数。若不要求兼容性,可通过其默认构造函数初始化 std::atomic

示例

缺陷报告

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

DR 应用于 出版时的行为 正确行为
P0558R1 C++11 曾要求准确类型匹配,因为从多个参数推导 T 仅从 atomic 参数推导 T

参阅

(C++11)(C++20 中弃用)
静态存储期的原子对象的常量初始化
(宏函数)
构造原子对象
(std::atomic<T> 的公开成员函数)