Namespaces
Variants

atomic_exchange, atomic_exchange_explicit

From cppreference.net
定义于头文件 <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 起)

以原子操作将 obj 指向的值替换为 desired ,并返回 obj 先前持有的值。该操作是读-修改-写操作。第一个版本按照 memory_order_seq_cst 对内存访问进行排序,第二个版本按照 order 参数对内存访问进行排序。

这是一个为所有 A 类型 原子对象 定义的 泛型函数 。该参数是指向volatile原子类型的指针,用于接受非volatile和 volatile (例如内存映射I/O)原子对象的地址,当对volatile原子对象应用此操作时,volatile语义会被保留。 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++ 文档 关于 atomic_exchange , atomic_exchange_explicit