std::atomic::fetch_sub

来自cppreference.com
< cpp‎ | atomic‎ | atomic
 
 
 
 
仅为 atomic<Integral>(C++11)atomic<Floating>(C++20) 模板特化的成员
(1)
T fetch_sub( T arg,
             std::memory_order order = std::memory_order_seq_cst ) noexcept;
T fetch_sub( T arg,
             std::memory_order order = std::memory_order_seq_cst ) volatile noexcept;
仅为 atomic<T*> 模板特化的成员
(2)
T* fetch_sub( std::ptrdiff_t arg,
              std::memory_order order = std::memory_order_seq_cst ) noexcept;
T* fetch_sub( std::ptrdiff_t arg,
              std::memory_order order = std::memory_order_seq_cst ) volatile noexcept;

以值和 arg 的算术减法结果原子地替换当前值。操作是读修改写操作。按照 order 的值影响内存。

对于有符号 Integral 类型,定义算术为使用补码表示。无未定义结果。

对于浮点类型,有影响的浮点环境可能异于调用方线程的浮点环境。操作不必服从对应的 std::numeric_limits 特性,但鼓励这么做。若结果不是其类型所能表示的值,则结果未指定,但操作不会另有未定义行为。

(C++20 起)

对于 T* 类型,结果可能是未定义地址,但操作不会另有未定义行为。若 T 不是对象类型则程序为病式。

目录

[编辑] 参数

arg - 算术减法的另一参数
order - 强制的内存顺序制约

[编辑] 返回值

*this修改顺序中立即前趋此函数效果的值。

[编辑] 缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

DR 应用于 出版时的行为 正确行为
P0558R1 C++11 曾容许指向 cv void 或函数的指针 使之为病式

[编辑] 参阅

从原子对象减去非原子值,并获得原子对象的先前值
(函数模板) [编辑]