命名空间
变体
操作

atomic_init

来自 cppreference.com
< c‎ | atomic
定义在头文件 <stdatomic.h>
void atomic_init( volatile A* obj, C desired );
(自 C11 起)

使用值 desired 初始化默认构造的原子对象 obj。该函数不是原子的:来自另一个线程的并发访问,即使是通过原子操作,也是数据竞争。

这是一个针对所有 原子对象类型 A 定义的 泛型函数。该参数是指向易失原子类型的指针,以接受非易失和 易失(例如内存映射 I/O)原子对象的地址,并且当对易失原子对象应用此操作时,会保留易失语义。C 是与 A 对应的非原子类型。

泛型函数的名称是宏还是带有外部链接的标识符,尚未确定。如果为了访问实际函数而抑制宏定义(例如,像 (atomic_init)(...) 一样使用括号),或者程序定义了一个名称与泛型函数相同的外部链接标识符,则行为未定义。

内容

[编辑] 参数

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

[编辑] 返回值

(无)

[编辑] 备注

atomic_init 是初始化动态分配的原子对象的唯一方法。例如

_Atomic int *p = malloc(sizeof(_Atomic int));
atomic_init(p, 42);

[编辑] 参考

  • C23 标准 (ISO/IEC 9899:2024)
  • 7.17.2.2 atomic_init 泛型函数 (p: 待定)
  • C17 标准 (ISO/IEC 9899:2018)
  • 7.17.2.2 atomic_init 泛型函数 (p: 201)
  • C11 标准 (ISO/IEC 9899:2011)
  • 7.17.2.2 atomic_init 泛型函数 (p: 274-275)

[编辑] 另请参阅

(C11)(C17 中已弃用)(C23 中已删除)
初始化新的原子对象
(函数宏) [编辑]
C++ 文档 for atomic_init