最終更新日時(UTC): 2026年03月21日 14時12分53秒
Raclamusi が更新

履歴 編集

function template
<unordered_set>

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

    namespace std {
      // operator==により、以下の演算子が使用可能になる (C++20)
      template <class Key, class Hash, class Pred, class Allocator>
      bool operator!=(const unordered_set<Key, Hash, Pred, Allocator>& a,
                      const unordered_set<Key, Hash, Pred, Allocator>& b); // (1) C++11
      template <class Key, class Hash, class Pred, class Allocator>
      constexpr bool operator!=(const unordered_set<Key, Hash, Pred, Allocator>& a,
                      const unordered_set<Key, Hash, Pred, Allocator>& b); // (1) C++26
    }

## 概要

`unordered_set` オブジェクトを非等値比較する。

## 要件

- `a.key_eq()` と `b.key_eq()` は同じふるまいをすること。
- `key_type` の等値比較演算子（`operator==`）で等値と判定された 2 つのオブジェクトは、`key_eq()` でも等値と判定されること。

## 戻り値

以下と等価：

    return !(a == b);

## 計算量

- 平均: `size()` に対して線形時間
- 最悪: `size()` に対して二乗時間

## 備考

- 本関数は、コンテナ内の要素の比較に `key_eq()` で返されるキー比較用関数オブジェクトを使用しないことに注意。
- 本関数は、標準コンテナの要件を満たさない。これは、標準コンテナの要件が `iterator` と `std::equal` を用いて定義されているためである。しかし、本関数の戻り値は、`!(a == b)` という意味においては、標準コンテナと同様とも考えることができる。

## 例

    #include <iostream>
    #include <string>
    #include <unordered_set>
    #include <iterator>
    #include <algorithm>

    template <class C>
    void print(const std::string& label, const C& c, std::ostream& os = std::cout)
    {
      os << label << ":";
      std::copy(std::begin(c), std::end(c), std::ostream_iterator<typename C::value_type>(os, ", "));
      os << std::endl;
    }

    int main()
    {
      std::cout << std::boolalpha;

      std::unordered_set<int> us1{ 1, 2, 3, };
      std::unordered_set<int> us2{ 4, 5, 6, };
      std::unordered_set<int> us3{ 1, 2, 3, };

      ::print("us1", us1);
      ::print("us2", us2);
      ::print("us3", us3);

      std::cout << "us1 != us2:" << (us1 != us2) << std::endl;
      std::cout << "us1 != us3:" << (us1 != us3) << std::endl;
    }

### 出力例

    us1:3, 2, 1,
    us2:6, 5, 4,
    us3:3, 2, 1,
    us1 != us2:true
    us1 != us3:false

注：`unordered_set` は非順序連想コンテナであるため、出力順序は無意味であることに注意

## バージョン

### 言語

- C++11

### 処理系

- Clang: 3.0 ✅, 3.1 ✅
- GCC: 4.4.7 ✅, 4.5.3 ✅, 4.6.3 ✅, 4.7.0 ✅
- ICC: ?
- Visual C++: ?

## 実装例

    namespace std {
      template <class Key, class Hash, class Pred, class Allocator>
      bool operator!=(const unordered_set<Key, Hash, Pred, Allocator>& a,
                      const unordered_set<Key, Hash, Pred, Allocator>& b)
      {
        return !(a == b);
      }
    }

## 関連項目

名前 | 説明
--- | ---
`operator==` | 等値比較

## 参照

- P0809R0 Comparing Unordered Containers
- P1614R2 The Mothership has Landed
  - C++20での三方比較演算子の追加と、関連する演算子の自動導出
- P3372R3 constexpr containers and adaptors