最終更新日時(UTC): 2025年04月23日 15時50分54秒
Keita Nonaka が更新

履歴 編集

function
<atomic>

# std::atomic::exchange(C++11)

    T
      exchange(T desired,
               memory_order order = memory_order_seq_cst
               ) volatile noexcept;                      // (1) C++11

    T
      exchange(T desired,
               memory_order order = memory_order_seq_cst
               ) noexcept;                               // (2) C++11
    constexpr T
      exchange(T desired,
               memory_order order = memory_order_seq_cst
               ) noexcept;                               // (2) C++26

## 概要

値を入れ替える

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

- (1) :
  - C++20 : `atomic<T>::is_always_lock_free`が`true`であること

## 効果

`order`で指定されたメモリオーダーにしたがって、現在の値を`desired`でアトミックに置き換える

## 戻り値

変更前の値が返される

## 例外

投げない

## 例

    #include <iostream>
    #include <atomic>

    int main()
    {
      std::atomic<int> x(1);

      if (x.exchange(2) == 1) {
        std::cout << "replaced 1 with 2" << std::endl;
      }
      else {
        std::cout << "replace failed" << std::endl;
      }
    }

### 出力

    replaced 1 with 2

## バージョン

### 言語

- C++11

### 処理系

- Clang: ??
- GCC: 4.7.0 ✅
- ICC: ??
- Visual C++: 2012 ✅, 2013 ✅

## 関連項目

- C++20 ほとんどの`volatile`を非推奨化

## 参照

- P1831R1 Deprecating `volatile`: library
  - C++20での、`volatile`版への制約追加
- P3309R3 `constexpr atomic` and `atomic_ref`
  - C++26で`constexpr`に対応した