std::atomic_ref<T>::fetch_sub
来自 cppreference.cn
< cpp | atomic | atomic ref
| 仅当 T 是除 cv bool 之外的算术类型或对象指针类型时提供 |
||
value_type fetch_sub( difference_type arg, std::memory_order order = |
(C++26 起为 constexpr) | |
以原子方式将引用对象的当前值替换为该值与 arg 的算术减法结果。此操作是读-修改-写操作。内存受 order 值的影响。
- 对于有符号整数类型，算术运算定义为使用二的补码表示。没有未定义的结果。
- 对于浮点类型，生效的浮点环境可能与调用线程的浮点环境不同。该操作无需符合相应的 std::numeric_limits 特征，但鼓励这样做。如果结果不是其类型可表示的值，则结果是未指定的，但操作否则没有未定义行为。
- 对于指针类型，结果可能是未定义地址，但操作否则没有未定义行为。
- 如果 std::remove_pointer_t<T> 不是完整对象类型，则程序格式错误。
此重载仅在 std::is_const_v<T> 为 false 时参与重载决议。
目录 |
[编辑] 参数
| arg | - | 算术减法的另一参数 |
| 顺序 | - | 要强制执行的内存顺序约束 |
[编辑] 返回值
紧接在该函数效果之前，由 *ptr 引用的值。
[编辑] 示例
| 本节不完整 原因：无示例 |
[编辑] 缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
| 缺陷报告 | 应用于 | 发布时的行为 | 正确的行为 |
|---|---|---|---|
| LWG 3508 (P3323R1) |
C++20 | fetch_sub 对 const T 无意义 |
限制为只接受非 const T |
