C++

參考

<atomic>

函式
<atomic>

std::atomic_fetch_add

template (integral) (1)
template <class T> T atomic_fetch_add (volatile atomic<T>* obj, T val) noexcept;template <class T> T atomic_fetch_add (atomic<T>* obj, T val) noexcept;
template (pointer) (2)
template <class U> U* atomic_fetch_add (volatile atomic<U*>* obj, ptrdiff_t val) noexcept;template <class U> U* atomic_fetch_add (atomic<U*>* obj, ptrdiff_t val) noexcept;
overloads (3)
T atomic_fetch_add (volatile A* obj, M val) noexcept;T atomic_fetch_add (A* obj, M val) noexcept;
Add to contained value
將 val 新增到 obj 所包含的值。

整個操作是原子的：在讀取其值（用於返回）的那一刻和該函式修改它的時候之間，該值不能被修改。

該函式使用順序一致性 (memory_order_seq_cst) 進行同步。要使用不同的記憶體順序來修改值，請參見 atomic_fetch_add_explicit。

有關 atomic 的等效成員函式，請參見 atomic::fetch_add 和 atomic::operator+=。

引數

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_add_explicit
增加包含值 (顯式記憶體順序) (函式)
atomic_fetch_sub
減少包含值 (函式)
atomic::fetch_add
新增到包含的值 (公有成員函式)
atomic::operator (複合賦值.)
複合賦值 (公有成員函式)