C++ 演算法庫 - equal_range() 函式

描述

C++ 函式 std::algorithm::equal_range() 返回與特定鍵匹配的元素範圍。它使用二分比較函式進行比較。範圍內的元素必須按排序順序排列。

宣告

以下是來自 std::algorithm 標頭檔案的 std::algorithm::equal_range() 函式的宣告。

C++98

template <class ForwardIterator, class T, class Compare>
pair<ForwardIterator,ForwardIterator>
equal_range (ForwardIterator first, ForwardIterator last,const T& val, Compare comp);

引數

• first - 指向初始位置的正向迭代器。

• last - 指向最終位置的正向迭代器。

• val - 要與元素比較的值。

• comp - 一個接受兩個引數並返回布林值的二元函式。

返回值

如果找到元素則返回一個子範圍。如果val與範圍內的任何值都不等價，則返回的子範圍長度為零，兩個迭代器都指向大於val的最近值（如果有），或者指向 last，如果val大於範圍內的所有元素。

異常

如果元素比較或迭代器上的操作引發異常，則丟擲異常。

請注意，無效引數會導致未定義的行為。

時間複雜度

大約 2*log2(n)+1 個元素。

示例

以下示例演示了 std::algorithm::equal_range() 函式的使用方法。

#include <iostream>
#include <vector>
#include <algorithm>

using namespace std;

bool binary_pred(int a, int b) {
   return (a > b);
}

int main(void) {
   vector<int> v = {2, 2, 2, 1, 1};
   int cnt = 0;

   auto range = equal_range(v.begin(), v.end(), 2, binary_pred);

   for (auto it = range.first; it != range.second; ++it)
      ++cnt;

   cout << "Element 2 occurs " << cnt << " times." << endl;

   return 0;
}

讓我們編譯並執行以上程式，這將產生以下結果：

Element 2 occurs 3 times.