atomic_fetch_sub, atomic_fetch_sub_explicit
来自cppreference.com
| 定义于头文件 <stdatomic.h>
|
||
| C atomic_fetch_sub( volatile A* obj, M arg ); |
(1) | (C11 起) |
| C atomic_fetch_sub_explicit( volatile A* obj, M arg, memory_order order ); |
(2) | (C11 起) |
以 *obj 的旧值减去 arg 的结果原子地替换 obj 的所指向值，并返回 *obj 先前保有的值。此操作是读修改写操作。第一版本按照 memory_order_seq_cst 排序内存访问，第二版本按照 order 排序内存访问。
这是为所有原子对象类型 A 定义的泛型函数。参数为指向 volatile 原子对象的指针，以接受非 volatile 与 volatile （例如内存映射 I/O ）的原子对象，而 volatile 语义在应用此操作时保留。 若 A 为原子整数类型则 M 是对应 A 的非原子类型，或若 A 为原子指针类型则 M 为 ptrdiff_t 。
泛型函数名是宏或是声明有外部链接的标识符是未指定的。若为访问实际函数压制宏定义（例如像 (atomic_fetch_sub)(...) 这样加括号），或程序定义拥有泛型函数名的外部标识符，则行为未定义。
对于有符号整数类型，定义算术为使用补码表示。无未定义结果。对于指针类型，结果可能是未定义地址，但运算不会另有未定义行为。
参数
| obj | - | 指向要修改的原子对象的指针 |
| arg | - | 要从存储于原子对象中的值减去的值 |
| order | - | 此操作的内存同步顺序：容许所有值 |
返回值
obj 所指向的原子对象先前保有的值。
引用
- C11 standard (ISO/IEC 9899:2011):
- 7.17.7.5 The atomic_fetch and modify generic functions (p: 284-285)
参阅
| 原子加法 (函数) |