Namespaces
Variants

atomic_fetch_sub, atomic_fetch_sub_explicit

From cppreference.net
定义于头文件 <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 先前持有的值。该操作是读-修改-写操作。第一个版本按照 memory_order_seq_cst 排序内存访问,第二个版本按照 order 参数排序内存访问。

这是一个为所有 原子对象类型 A 定义的 泛型函数 。参数为指向易变原子类型的指针,用以接受非易变和 易变 (如内存映射I/O)原子对象的地址,且在对此类易变原子对象应用本操作时保留易变语义。若 A 为原子整型,则 M 为对应 A 的非原子类型;若 A 为原子指针类型,则 M ptrdiff_t

未指定泛型函数的名称是宏还是具有外部链接的标识符。若为访问实际函数而抑制宏定义(例如采用括号形式如 ( atomic_fetch_sub ) ( ... ) ),或程序定义了与泛型函数同名的外部标识符,则行为未定义。

对于有符号整数类型,算术运算采用二进制补码表示法定义。不存在未定义结果。对于指针类型,结果可能是未定义的地址,但除此之外操作不存在未定义行为。

目录

参数

obj - 指向要修改的原子对象的指针
arg - 要从原子对象存储值中减去的数值
order - 此操作的内存同步顺序:允许所有取值

返回值

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

参考文献

  • C17 标准 (ISO/IEC 9899:2018):
  • 7.17.7.5 原子获取与修改通用函数 (p: 208)
  • C11 标准 (ISO/IEC 9899:2011):
  • 7.17.7.5 atomic_fetch 和 modify 通用函数 (p: 284-285)

参见

原子加法
(函数)
C++ 文档 关于 atomic_fetch_sub , atomic_fetch_sub_explicit