C++ Map equal_range()用法及代碼示例

描述

C++ 函數std::multimap::equal_range()返回匹配特定鍵的元素範圍。

range由兩個迭代器定義，一個指向不小於key的第一個元素k另一個指向第一個大於鍵的元素k。

聲明

以下是 std::multimap::equal_range() 函數形式 std::map 頭文件的聲明。

C++98

pair<const_iterator,const_iterator> equal_range (const key_type& k) const;
pair<iterator,iterator>             equal_range (const key_type& k);

參數

k- 要搜索的鍵。

返回值

如果對象是常量限定的，則方法返回一對常量迭代器，否則返回一對非常量迭代器。

異常

如果拋出異常，對容器沒有影響。

時間複雜度

對數，即 O(log n)

示例

下麵的例子展示了 std::multimap::equal_range() 函數的用法。

#include <iostream>
#include <map>

using namespace std;

int main(void) {
   multimap<char, int> m = {
      {'a', 1},
      {'b', 2},
      {'b', 3},
      {'b', 4},
      {'d', 5}
        };

   auto ret = m.equal_range('b');

   cout << "Elements associated with key 'b':";

   for (auto it = ret.first; it != ret.second; ++it)
      cout << it->second << " ";
   cout << endl;

   return 0;
}

讓我們編譯並運行上麵的程序，這將產生以下結果——

Elements associated with key 'b':2 3 4