最終更新日時: 2024年12月23日 16時58分47秒 (JST)
Akira Takahashi が更新

履歴 編集

function
<atomic>

# std::atomic::operator|=(C++11)

    T operator|=(T operand) volatile noexcept;  // (1) C++11

    T operator|=(T operand) noexcept;           // (2) C++11
    constexpr T operator|=(T operand) noexcept; // (2) C++26

## 概要

OR演算を行う

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

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

## 戻り値

以下と等価の式により、演算結果の値が返る：

    return fetch_or(operand) | operand;

## 例外

投げない

## 備考

この関数は、`atomic`クラスの整数型に対する特殊化で定義される。

## 例

### 基本的な使い方

    #include <iostream>
    #include <atomic>
    #include <bitset>

    int main()
    {
      int a = 0x0b;
      int b = 0x0e;

      std::atomic<int> x(a);

      x |= b;

      std::cout << std::bitset<4>(a).to_string() << std::endl;
      std::cout << std::bitset<4>(b).to_string() << std::endl;
      std::cout << std::bitset<4>(x.load()).to_string() << std::endl;
    }

#### 出力

    1011
    1110
    1111

### 複数スレッドからビット複合演算を行う例 (C++14)

    #include <iostream>
    #include <atomic>
    #include <thread>
    #include <bitset>

    int main()
    {
      std::atomic<int> x{0b0110};

      // 複数スレッドでビット複合演算を呼んでも、
      // 最終的に全てのスレッドでのビット複合演算が処理された値になる
      std::thread t1 {[&x] {
        x |= 0b0001;
      }};
      std::thread t2 {[&x] {
        x |= 0b1000;
      }};

      t1.join();
      t2.join();

      int value = x.load();
      std::cout << std::bitset<4>(value).to_string() << std::endl;
    }

#### 出力

    1111

## バージョン

### 言語

- C++11

### 処理系

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

## 関連項目

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

## 参照

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