atomic_exchange,atomic_exchange_explicit
来自 cppreference.com
在头文件 <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
|