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.