op_xor_assign.md

operator^=

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

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

概要

XOR演算を行う

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

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

戻り値

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

return fetch_xor(operand) ^ operand;

• fetch_xor[link fetch_xor.md]

例外

投げない

備考

この関数は、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;
}

• x ^= b;[color ff0000]
• x.load()[link load.md]
• to_string()[link /reference/bitset/bitset/to_string.md]

出力

1011
1110
0101

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

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

int main()
{
  int ar[] = {1, 2, 3, 4, 5};
  std::atomic<int> hash{ar[0]};

  // XORで配列のハッシュ値を並列に計算する。
  // 複数スレッドでビット複合演算を呼んでも、
  // 最終的に全てのスレッドでのビット複合演算が処理された値になる
  std::thread t1 {[&hash, ar] {
    hash ^= ar[1];
    hash ^= ar[2];
  }};
  std::thread t2 {[&hash, ar] {
    hash ^= ar[3];
    hash ^= ar[4];
  }};

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

  int value = hash.load();
  std::cout << std::hex << value << std::endl;
}

• hash ^= ar[1];[color ff0000]
• hash ^= ar[2];[color ff0000]
• hash ^= ar[3];[color ff0000]
• hash ^= ar[4];[color ff0000]
• hash.load()[link load.md]

出力

1

バージョン

言語

• C++11

処理系

• Clang: 3.2
• GCC: 4.7.0
• Visual C++: 2012, 2013

関連項目

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

参照

• P1831R1 Deprecating volatile: library
  • C++20での、volatile版への制約追加