std::unordered_multimap<Key,T,Hash,KeyEqual,Allocator>:: equal_range
From cppreference.net
<
cpp
|
container
|
unordered multimap
|
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
和
KeyEqual
均为
透明函数对象
时参与重载决议。这要求该
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 <unordered_map> int main() { std::unordered_multimap<int,char> map = {{1, 'a'},{1, 'b'},{1, 'd'},{2, 'b'}}; auto range = map.equal_range(1); for (auto it = range.first; it != range.second; ++it) std::cout << it->first << ' ' << it->second << '\n'; }
输出:
1 a 1 b 1 d
参阅
|
查找具有特定键的元素
(公开成员函数) |
|
|
(C++20)
|
检查容器是否包含具有特定键的元素
(公开成员函数) |
|
返回匹配特定键的元素数量
(公开成员函数) |
|
|
返回匹配特定键的元素范围
(函数模板) |