最終更新日時(UTC):
が更新

履歴 編集

function
<unordered_map>

std::unordered_multimap::equal_range(C++11)

pair<iterator, iterator>
  equal_range(const key_type& x);       // (1) C++11
pair<const_iterator, const_iterator>
  equal_range(const key_type& x) const; // (2) C++11

template <class K>
pair<iterator, iterator>
  equal_range(const K& k);              // (3) C++20
template <class K>
pair<const_iterator, const_iterator>
  equal_range(const K& k) const;        // (4) C++20

概要

コンテナ内の、指定されたキーと等しい全てのキー要素を含む範囲の境界を返す。

もし指定されたキーがコンテナ内のどのキーともマッチしなかった場合、戻り値の範囲は長さ 0 になり、両方のイテレータは end を指す。

  • (1) : 非constthisに対してキーxを検索し、合致する全ての要素を含む範囲を取得する
  • (2) : constthisに対してキーxを検索し、合致する全ての要素を含む範囲を取得する
  • (3) : 非constthisに対してキーkを透過的に検索し、合致する全ての要素を含む範囲を取得する
  • (4) : constthisに対してキーkを透過的に検索し、合致する全ての要素を含む範囲を取得する

(3)、(4)の透過的な検索は、Hash::transparent_key_equalが定義される場合に有効になる機能であり、例としてunordered_multimap<string, int> m;に対してm.equal_range("key");のようにstring型のキーを持つ連想コンテナの検索インタフェースに文字列リテラルを渡した際、stringの一時オブジェクトが作られないようにできる。詳細はstd::hashクラスのページを参照。

パラメータ

  • x : 比較されるキー値。key_type はメンバ型であり、map コンテナ内で Key の別名として定義される。ここで Key は最初のテンプレートパラメータである。
  • k : 検索するキー。key_typeと透過的に比較可能な型K型のキーである。

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

  • (3), (4) : Hash::transparent_key_equal型が定義されていること

戻り値

合致する要素の範囲を表す pair オブジェクトを返す。pair::first は 範囲の下境界にあたり、pair::second は 範囲の上境界にあたる。

そのような要素がない場合には、make_pair(end(), end())を返す。

iterator はメンバ型であり unordered_multimap において双方向イテレータとして定義される。

計算量

  • 平均: 定数時間
  • 最悪: size について線形時間

#include <iostream>
#include <unordered_map>
#include <algorithm>

using it_t = std::unordered_multimap<int,char>::iterator;

void disp( std::pair<const int,char>& p) {
  std::cout << p.second << std::endl;
}

int main()
{
  std::unordered_multimap<int,char> um;

  um.insert(std::make_pair(1,'a'));
  um.insert(std::make_pair(1,'b'));
  um.insert(std::make_pair(1,'c'));

  std::pair<it_t, it_t> ret = um.equal_range(1);

  std::cout << "--- ret" << std::endl;
  std::for_each(ret.first, ret.second, disp);


  std::pair<it_t, it_t> ret2 = um.equal_range(0);
  std::cout << "--- ret2" << std::endl;
  std::cout << "first:" << ( ret2.first == um.end() )  << std::endl;
  std::cout << "second:" << ( ret2.second == um.end() )  << std::endl;

  return 0;
}

出力

--- ret
a
b
c
--- ret2
first:1
second:1

バージョン

言語

  • C++11

処理系

関連項目

名前 説明
count 指定したキーにマッチする要素の数を返す
find 指定したキーで要素を探す

参照