命名空间
变体
操作

std::atomic_ref<T>::compare_exchange_weak, std::atomic_ref<T>::compare_exchange_strong

来自 cppreference.cn
< cpp‎ | atomic‎ | atomic ref
 
C++
 
并发支持库
线程
(C++11)
(C++20)
(C++17)(C++17)
this_thread 命名空间
(C++11)
(C++11)
(C++11)
(C++11)
协同取消
互斥
(C++11)
(C++11)
(C++17)
通用锁管理
(C++11)
(C++11)
(C++17)
(C++11)
(C++14)
(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++20)(C++20)
闩锁和屏障
(C++20)
(C++20)
期望
(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++26)
(C++26)
原子类型
(C++11)
(C++20)
(C++11)
原子类型的初始化
(C++11)(C++20 中已弃用)
(C++11)(C++20 中已弃用)
(C++11)
内存顺序
(C++11)
(C++11)(C++26 中已弃用)
(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++11)(C++11)
(C++26)(C++26)
(C++26)(C++26)
(C++11)
(C++20)(C++20)
(C++20)
(C++20)
原子标志的自由函数
(C++11)(C++11)
(C++11)(C++11)
(C++20)(C++20)
(C++20)(C++20)
(C++20)
(C++20)
 
std::atomic_ref
成员函数
atomic_ref::compare_exchange_strongatomic_ref::compare_exchange_weak
(C++26)
算术类型的操作
（除了 bool 和对象指针）
整数类型的操作
（除了 bool 和对象指针）
(C++26)
(C++26)
整数类型的操作
（除了 bool）
常量
 
bool compare_exchange_weak

    ( value_type& expected, value_type desired,
      std::memory_order success,

      std::memory_order failure ) const noexcept;
 (1) (constexpr since C++26)
bool compare_exchange_weak

    ( value_type& expected, value_type desired,
      std::memory_order order =

          std::memory_order_seq_cst ) const noexcept;
 (2) (constexpr since C++26)
bool compare_exchange_strong

    ( value_type& expected, value_type desired,
      std::memory_order success,

      std::memory_order failure ) const noexcept;
 (3) (constexpr since C++26)
bool compare_exchange_strong

    ( value_type& expected, value_type desired,
      std::memory_order order =

          std::memory_order_seq_cst ) const noexcept;
 (4) (constexpr since C++26)

原子地比较被引用对象的值表示与 expected 的值表示，如果它们按位相等，则用 desired 替换前者（执行读-修改-写操作）。否则，将引用对象中存储的实际值加载到 expected 中（执行加载操作）。

1,3) 读-修改-写和加载操作的内存模型分别是 success 和 failure。
2,4) order 用于读-修改-写和加载操作，但如果 order 分别是 std::memory_order_acq_rel 或 std::memory_order_release，则加载操作使用 std::memory_order_acquire 和 std::memory_order_relaxed。

这些重载仅在 std::is_const_v<T> 为 false 时参与重载解析。

如果 failure 不是 std::memory_order_relaxed、 std::memory_order_consume、 std::memory_order_acquire 或 std::memory_order_seq_cst，则行为未定义。

目录

[编辑] 参数

expected - 对期望在 atomic_ref 对象引用的对象中找到的值的引用
desired - 如果与预期值相符，则存储在引用对象中的值
success - 如果比较成功，则用于读-修改-写操作的内存同步顺序
failure - 如果比较失败，则用于加载操作的内存同步顺序
order - 用于两个操作的内存同步顺序

[编辑] 返回值

true 如果引用的对象已成功更改，否则为 false。

[编辑] 注解

比较和复制是按位的（类似于 std::memcmp 和 std::memcpy）；不使用构造函数、赋值运算符或比较运算符。

函数的弱形式 (1,2) 允许伪失败，即，即使它们相等，也表现得好像 *this != expected。当比较和交换在循环中时，弱版本将在某些平台上产生更好的性能。

当弱比较和交换需要循环而强比较和交换不需要时，除非 value_type 的对象表示可能包含陷阱位，或者为相同的值提供多个对象表示（例如，浮点 NaN），否则强比较和交换是更可取的。在这些情况下，弱比较和交换通常有效，因为它会快速收敛到某个稳定的对象表示。

对于一个联合体，其位参与某些成员的值表示，但不参与其他成员的值表示，比较和交换可能总是失败，因为当这些填充位不参与活动成员的值表示时，它们具有不确定的值。

从不参与对象值表示的填充位将被忽略。

[编辑] 缺陷报告

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

DR 应用于 已发布行为 正确行为
LWG 3508
(P3323R1)		 C++20 compare_exchange_weak 和 compare_exchange_strong
对于 const T 是无意义的		 约束为仅接受非 const T

[编辑] 示例

本节不完整
原因：没有示例
取自“https://cppreference.cn/mwiki/index.php?title=cpp/atomic/atomic_ref/compare_exchange&oldid=179568”