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 (复合赋值.)
复合赋值 (公有成员函数)