atomic_exchange, atomic_exchange_explicit
|
定义于头文件
<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
|
|