C++ 算法库 - equal_range() 函数

---

描述

C++ 函数std::algorithm::equal_range()返回与特定键匹配的元素范围。它使用二进制比较函数进行比较。范围中的元素必须按排序顺序排列。

宣言

以下是 std::algorithm::equal_range() 函数形式 std::algorithm 标头的声明。

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 的最近值（如果有的话），或者如果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.