命名空间
变体
操作

atomic_exchange,atomic_exchange_explicit

来自 cppreference.com
< c‎ | atomic
在头文件 <stdatomic.h> 中定义
C atomic_exchange( volatile A* obj, C desired );
(1) (自 C11 起)
C atomic_exchange_explicit( volatile A* obj, C desired, memory_order order );
(2) (自 C11 起)

原子地用 desired 替换 obj 指向的值,并返回之前 obj 持有的值。此操作是读-修改-写操作。第一个版本按照 memory_order_seq_cst 排序内存访问,第二个版本按照 order 排序内存访问。

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

泛型函数的名称是宏还是具有外部链接的标识符尚不清楚。如果为了访问实际函数而抑制宏定义(例如,用括号括起来,如 (atomic_exchange)(...)),或者程序定义了具有泛型函数名称的外部标识符,则行为未定义。

内容

[编辑] 参数

obj - 指向要修改的原子对象的指针
desired - 要用来替换原子对象的值
order - 此操作的内存同步排序:允许所有值

[编辑] 返回值

obj 指向的原子对象先前持有的值。

[编辑] 参考文献

  • C17 标准 (ISO/IEC 9899:2018)
  • 7.17.7.3 atomic_exchange 泛型函数 (p: 207)
  • C11 标准 (ISO/IEC 9899:2011)
  • 7.17.7.3 atomic_exchange 泛型函数 (p: 283)

[编辑] 另请参见

如果旧值为预期值,则将值与原子对象交换,否则读取旧值
(函数) [编辑]
C++ 文档 for atomic_exchange, atomic_exchange_explicit