std::atomic<T>::fetch_sub

< cpp‎ | atomic‎ | atomic
 
C++
 
原子操作库
类
(C++11)
(C++20)
函数
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)
(C++20)(C++20)
(C++20)
(C++20)
原子标志
(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++20)(C++20)
(C++20)(C++20)
(C++20)
(C++20)
初始化
(C++11)(C++20 中弃用)
(C++11)(C++20 中弃用)
(C++11)(C++20 中弃用)
内存顺序
(C++11)
(C++11)
(C++11)
(C++11)
 
std::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 类型，定义算术为使用补码表示。无未定义结果。

对于 T* 类型，结果可能是未定义地址，但此外操作不会有未定义行为。若 T 不是对象类型则程序为谬构。

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

若 std::atomic<T>::is_always_lock_free 为 false 则 volatile 限定版本被弃用。

(C++20 起)

参数

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

返回值

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

缺陷报告

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

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

参阅

(C++11)(C++11)
 从原子对象减去非原子值，并获得原子对象的先前值
(函数模板)