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.