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 (複合賦值.)
複合賦值 (公有成員函式)