最終更新日時(UTC): 2024年06月11日 13時45分38秒
Akira Takahashi が更新

履歴 編集

function template
<array>

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

    namespace std {
      template <class T, size_t N>
      bool operator==(const array<T, N>& x, const array<T, N>& y);           // C++11

      template <class T, size_t N>
      constexpr bool operator==(const array<T, N>& x, const array<T, N>& y); // C++20
    }

## 概要

`array`オブジェクトの等値比較を行う。

## 要件

型`T`が`operator==`で等値比較可能であること。

## 効果

- C++11 : `distance(x.begin(), x.end()) == distance(y.begin(), y.end()) && equal(x.begin(), x.end(), y.begin());`
- C++14 : `equal(x.begin(), x.end(), y.begin(), y.end());`

## 戻り値

`x`と`y`の要素が全て等値であれば`true`、そうでなければ`false`を返す。

## 計算量

線形時間

## 備考

- この演算子により、以下の演算子が使用可能になる (C++20)：
  - `operator!=`

## 例

    #include <iostream>
    #include <array>

    int main()
    {
      std::array<int, 3> x = {1, 2, 3};
      std::array<int, 3> y = {1, 2, 3};

      if (x == y) {
        std::cout << "equal" << std::endl;
      }
      else {
        std::cout << "not equal" << std::endl;
      }
    }

### 出力

    equal

## バージョン

### 言語

- C++11

### 処理系

- Clang: ??
- GCC: 4.7.0 ✅
- ICC: ??
- Visual C++: 2008 (std::tr1) ✅, 2010 ✅, 2012 ✅

## 参照

- LWG Issue 2257. Simplify container requirements with the new algorithms
  - C++14から、2つ目のイテレータ範囲のendイテレータをとる`equal()`アルゴリズムを使用するようになった。
- P1023R0 `constexpr` comparison operators for `std::array`
- P1614R2 The Mothership has Landed
  - C++20での三方比較演算子の追加と、関連する演算子の自動導出