std::unordered_multiset<Key,Hash,KeyEqual,Allocator>::equal_range
来自cppreference.com
<tbody>
</tbody>
std::pair<iterator, iterator> equal_range( const Key& key ); |
(1) | (C++11 起) |
std::pair<const_iterator, const_iterator> equal_range( const Key& key ) const; |
(2) | (C++11 起) |
template< class K > std::pair<iterator, iterator> equal_range( const K& x ); |
(3) | (C++20 起) |
template< class K > std::pair<const_iterator, const_iterator> equal_range( const K& x ) const; |
(4) | (C++20 起) |
1,2) 返回容器中所有键等于
key 的元素范围。范围以两个迭代器定义，第一个指向所需范围的首元素，而第二个指向范围的尾后一位元素。3,4) 返回含有容器中所有键等价于
x 的元素的范围。此重载只有在Hash::is_transparent 与 KeyEqual::is_transparent 均合法并指代类型时才会参与重载决议。这假设使得 Hash 能用 K 和 Key 类型调用，并且 KeyEqual 是透明的，进而允许调用此函数时不需要构造 Key 的实例。参数
| key | - | 要与元素比较的键值 |
| x | - | 任何能与键通透比较的类型的值 |
返回值
含一对定义所需范围的迭代器的 std::pair。若无这种元素，则将尾后（见 end()）迭代器作为 pair 的两个元素返回。
复杂度
平均情况与带有键 key 的元素数成线性，最坏情况与容器大小成线性。
注解
| 功能特性测试宏 | 值 | 标准 | 功能特性 |
|---|---|---|---|
__cpp_lib_generic_unordered_lookup |
201811L |
(C++20) | 无序关联容器中的异质比较查找，重载 (3,4) |
示例
对给定字符串估计字符频率。
运行此代码
#include <iostream>
#include <iterator>
#include <string>
#include <unordered_set>
int main()
{
std::string sentence{"cppreference.com"};
std::cout << "The sentence: " << sentence << '\n';
std::unordered_multiset<char> sequence;
for (char x : sentence)
sequence.insert(x);
std::cout << "The sequence: { ";
for (char x : sequence)
std::cout << x << ' ';
std::cout << "}\n" "Symbol:Frequency: ";
for (auto it = sequence.begin(); it != sequence.end();)
{
if (auto [first, last] = sequence.equal_range(*it); first != last)
{
std::cout << *first << ":" << std::distance(first, last) << " ";
it = last;
}
else
++it;
}
}
可能的输出：
The sentence: cppreference.com
The sequence: { m o c c c p p r r e e e e f n . }
Symbol:Frequency: m:1 o:1 c:3 p:2 r:2 e:4 f:1 n:1 .:1
参阅
| 寻找带有特定键的元素 (公开成员函数) | |
(C++20) |
检查容器是否含有带特定键的元素 (公开成员函数) |
| 返回匹配特定键的元素数量 (公开成员函数) | |
| 返回匹配特定键值的元素范围 (函数模板) |