Namespaces
Variants

std::atomic_ref<T>:: operator+=,-=

From cppreference.net
Concurrency support library
Threads
(C++11)
(C++20)
this_thread namespace
(C++11)
(C++11)
Cooperative cancellation
Mutual exclusion
Generic lock management
Condition variables
(C++11)
Semaphores
Latches and Barriers
(C++20)
(C++20)
Futures
(C++11)
(C++11)
(C++11)
Safe reclamation
Hazard pointers
Atomic types
(C++11)
(C++20)
Initialization of atomic types
(C++11) (deprecated in C++20)
(C++11) (deprecated in C++20)
Memory ordering
(C++11) (deprecated in C++26)
Free functions for atomic operations
Free functions for atomic flags
仅当 T 为除 cv bool 外的算术类型或对象指针类型时提供
value_type operator + = ( difference_type arg ) const noexcept ;
(1) (自 C++26 起为 constexpr)
value_type operator - = ( difference_type arg ) const noexcept ;
(2) (自 C++26 起为 constexpr)

以原子方式将 * ptr 引用的当前值替换为先前值与 arg 参与计算的结果。这些操作属于读-修改-写操作。

1) operator + = 执行原子加法操作。等效于 return fetch_add ( arg ) + arg ;
2) operator - = 执行原子减法操作。等价于 return fetch_sub ( arg ) - arg ;
  • 对于有符号整数类型,算术运算采用二进制补码表示法定义,不存在未定义结果。
  • 对于浮点类型,生效的 浮点环境 可能与调用线程的浮点环境不同。该运算不需要符合对应的 std::numeric_limits 特性,但建议符合。如果结果不是其类型可表示的值,则结果未指定,但该运算没有其他未定义行为。
  • 对于指针类型,结果可能是一个未定义的地址,但该运算没有其他未定义行为。

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

目录

参数

arg - 算术运算的参数

返回值

结果值(即在对应成员函数生效前,对 * ptr 所引用值应用相应二元运算符得到的结果)。

注释

与大多数复合赋值运算符不同, atomic_ref 的复合赋值运算符返回存储值的副本,而非对 arg 的引用。

示例

缺陷报告

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

DR 适用范围 发布时的行为 正确行为
LWG 3508
( P3323R1 )
C++20 复合赋值运算符对 const T 无意义 约束为仅接受非 const T

参见

以原子方式将参数加到引用对象中存储的值,并获取先前持有的值
(公开成员函数)
以原子方式从引用对象中存储的值减去参数,并获取先前持有的值
(公开成员函数)
以原子方式将引用对象递增或递减一
(公开成员函数)
以原子方式对引用值执行按位与、或、异或操作
(公开成员函数)