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

描述

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

宣告

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

C++98

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

引數

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

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

• val − 用於比較元素的值。

返回值

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

異常

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

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

時間複雜度

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

示例

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

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

using namespace std;

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

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

   for (auto it = range.first; it != range.second; ++it)
      ++cnt;
	
   cout << "Element 2 occurs " << cnt << " times." << endl;

   return 0;
}

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

Element 2 occurs 4 times.