exchange.md

exchange

• atomic[meta header]
• std[meta namespace]
• atomic_ref[meta class]
• function[meta id-type]
• cpp20[meta cpp]

T exchange(T desired, memory_order order = memory_order_seq_cst) const noexcept;

• memory_order[link /reference/atomic/memory_order.md]
• memory_order_seq_cst[link /reference/atomic/memory_order.md]

概要

値を入れ替える

効果

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;
  }
}

• exchange[color ff0000]

出力

replaced 1 by 2

バージョン

言語

• C++20

処理系

• Clang: (9.0時点で実装なし)
• GCC: 10.1
• Visual C++: ??