std::atomic_ref::exchange

T
  exchange(T desired,
           memory_order order = memory_order_seq_cst) const noexcept; // (1) C++20
constexpr value_type
  exchange(value_type desired,
           memory_order order = memory_order_seq_cst) const noexcept; // (1) C++26

概要

値を入れ替える

テンプレートパラメータ制約

• C++26 : is_const_v<T>がfalseであること

効果

orderで指定されたメモリオーダーにしたがって、*thisが参照する値をdesiredでアトミックに置き換える

戻り値

この関数の呼び出し前に*thisが参照していた値が、アトミックに返される

例外

投げない

例

#include <iostream>
#include <atomic>

int main()
{
  int value = 1;
  std::atomic_ref<int> x{value};

  if (x.exchange(2) == 1) {
    std::cout << "replaced 1 by 2" << std::endl;
  }
}

#include <iostream>

#include <atomic>

​

int main()

{

  int value = 1;

  std::atomic_ref<int> x{value};

​

  if (x.exchange(2) == 1) {

    std::cout << "replaced 1 by 2" << std::endl;

  }

}

​

出力

replaced 1 by 2

バージョン

言語

• C++20

処理系

• Clang: 9.0 ❌
• GCC: 10.1 ✅
• Visual C++: ??

参照

• P3323R1 cv-qualified types in atomic and atomic_ref
  • C++26でCV修飾されたテンプレート引数を受け取れるようになった
• P3309R3 constexpr atomic and atomic_ref
  • C++26でconstexprに対応した