Namespaces
Variants

std::atomic_ref<T>:: fetch_sub

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_sub
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_sub ( difference_type arg,

std:: memory_order order =

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

以原子方式将引用对象的当前值替换为原值与 arg 进行算术减法的结果。此操作属于读-改-写操作。内存访问顺序根据 order 参数的值进行约束。

  • 对于有符号整数类型，算术运算采用二进制补码表示法定义，不存在未定义结果。
  • 对于浮点类型，实际生效的 浮点环境 可能与调用线程的浮点环境不同。运算不必符合对应的 std::numeric_limits 特性，但建议符合。若结果不是该类型可表示的值，则结果未指定，但该运算不具其他未定义行为。
  • 对于指针类型，结果可能是未定义地址，但该运算不具其他未定义行为。

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

目录

参数

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

返回值

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

示例

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

缺陷报告

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

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