Namespaces
Variants

std::atomic_ref<T>:: fetch_add

From cppreference.net
C++
Concurrency support library
Threads
(C++11)
(C++20)
(C++17) (C++17)
this_thread namespace
(C++11)
(C++11)
Cooperative cancellation
Mutual exclusion
Generic lock management
Condition variables
(C++11)
(C++11)
(C++11)
(C++11)
Semaphores
(C++20) (C++20)
Latches and Barriers
(C++20)
(C++20)
Futures
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Safe reclamation
Hazard pointers
(C++26)
(C++26)
(C++26)
Atomic types
(C++11)
(C++20)
(C++11)
Initialization of atomic types
(C++11) (deprecated in C++20)
(C++11) (deprecated in C++20)
(C++11)
Memory ordering
(C++11)
(C++11) (deprecated in C++26)
(C++11)
(C++11)
Free functions for atomic operations
(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++26) (C++26)
(C++26) (C++26)
(C++11)
(C++20) (C++20)
(C++20)
(C++20)
Free functions for atomic flags
(C++11) (C++11)
(C++11) (C++11)
(C++20) (C++20)
(C++20) (C++20)
(C++20)
(C++20)
std::atomic_ref
Member functions
(C++26)
Operations for arithmetic types
(except bool and pointer-to-object)
atomic_ref::fetch_add
Operations for integral types
(except bool and pointer-to-object)
(C++26)
(C++26)
Operations for integral types
(except bool )
Constants
仅当 T 为除 cv bool 外的算术类型或指向对象类型的指针时提供
value_type fetch_add ( difference_type arg,

std:: memory_order order =

std:: memory_order_seq_cst ) const noexcept ;
(自 C++26 起为 constexpr)

原子地将 * ptr 引用的当前值替换为原值与 arg 的算术加法结果。此操作是读-修改-写操作。内存受影响的方式取决于 order 的值。

  • 对于有符号整数类型，算术运算定义为使用二进制补码表示。不存在未定义结果。
  • 对于浮点类型，生效的 浮点环境 可能与调用线程的浮点环境不同。该操作不必符合相应的 std::numeric_limits 特性，但鼓励这样做。如果结果不是其类型的可表示值，则结果未指定，但该操作没有其他未定义行为。
  • 对于指针类型，结果可能是一个未定义的地址，但该操作没有其他未定义行为。

此重载仅当 std:: is_const_v < T > 为 false 时参与重载决议。

目录

参数

arg - 算术加法运算的另一个参数
order - 需强制执行的内存顺序约束

返回值

在此函数生效前， * ptr 所引用的值。

示例

本节内容不完整
原因：缺少示例

缺陷报告

以下行为变更缺陷报告被追溯应用于先前发布的C++标准。

缺陷报告 适用范围 发布时行为 正确行为
LWG 3508
( P3323R1 ) 		C++20 fetch_add 对于 const T 无意义 约束为仅接受非 const T