std::unordered_multiset<Key,Hash,KeyEqual,Allocator>::equal_range
< cpp | container | unordered multiset
| 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 均合法并指代类型才参与重载决议。这假设能用 K 和 Key 类型一起调用这种 Hash ，还有 KeyEqual 是通透的，进而允许不用构造 Key 的实例就调用此函数。参数
| key | - | 要与元素比较的键值 |
| x | - | 任何能与键通透比较的类型的值 |
返回值
含一对定义所需范围的迭代器的 std::pair 。若无这种元素，则将尾后（见 end() ）迭代器作为 pair 的两个元素返回。
复杂度
平均情况与带关键 key 的元素数成线性，最坏情况与容器大小成线性。
示例
| 本节未完成 原因：暂无示例 |
参阅
| 寻找带有特定键的元素 (公开成员函数) |