命名空间
变体
操作

atomic_init

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

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

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

未指定泛型函数的名称是宏还是具有外部链接的标识符。如果为了访问实际函数而禁止宏定义(例如用括号括起来,如 (atomic_init)(...)),或者程序定义了一个与泛型函数名称相同的外部标识符,则行为未定义。

目录

[编辑] 参数

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

[编辑] 返回值

(无)

[编辑] 注意

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