C++

参考

<atomic>

函数
<atomic>

std::atomic_fetch_sub

template (integral) (1)
template <class T> T atomic_fetch_sub (volatile atomic<T>* obj, T val) noexcept;template <class T> T atomic_fetch_sub (atomic<T>* obj, T val) noexcept;
template (pointer) (2)
template <class U> U* atomic_fetch_sub (volatile atomic<U*>* obj, ptrdiff_t val) noexcept;template <class U> U* atomic_fetch_sub (atomic<U*>* obj, ptrdiff_t val) noexcept;
overloads (3)
T atomic_fetch_sub (volatile A* obj, M val) noexcept;T atomic_fetch_sub (A* obj, M val) noexcept;
从包含的值中减去
将 val 从 obj 包含的值中减去。

整个操作是原子的：在读取其值（用于返回）的那一刻和该函数修改它的时候之间，该值不能被修改。

该函数使用 memory_order_seq_cst（顺序一致性）进行同步。要使用不同的 内存排序 修改该值，请参阅 atomic_fetch_sub_explicit。

请参阅 atomic::fetch_sub 和 atomic::operator-= 以获取 atomic 的等效成员函数。

参数

obj
指向一个 atomic 对象的指针，该对象包含一个 整数 或 指针 值。
类型 A 代表其他重载的 原子类型（以防库不将 C 风格的原子类型 实现为 atomic 的实例化）。
val
要减去的值。
T 是原子对象包含的值的类型（atomic 的模板参数）。
ptrdiff_t 是一个有符号整数类型。
M 是 T（如果 T 是 整数类型）或 ptrdiff_t（如果 T 是指针）。

返回值

调用前的存储值。
T（或 U*）是原子对象包含的值的类型（atomic 的模板参数）。

数据竞争

无数据竞争（原子操作）。该操作使用*顺序一致性*（memory_order_seq_cst）。

异常安全

无异常保证： 绝不抛出异常。

另见

atomic_fetch_sub_explicit
减少包含值 (显式内存顺序) (函数)
atomic_fetch_add
增加包含值 (函数)
atomic::fetch_sub
从包含的值中减去 (public member function)
atomic::operator (复合赋值.)
复合赋值 (公有成员函数)