std::unordered_multimap<Key,T,Hash,KeyEqual,Allocator>::equal_range

来自cppreference.com
 
 
 
 
std::pair<iterator,iterator> equal_range( const Key& key );
(1) (C++11 起)
std::pair<iterator,iterator> equal_range( const Key& key, std::size_t hash );
(1) (C++20 起)
std::pair<const_iterator,const_iterator> equal_range( const Key& key ) const;
(2) (C++11 起)
std::pair<const_iterator,const_iterator> equal_range( const Key& key,
                                                      std::size_t hash ) const;
(2) (C++20 起)
template< class K >
std::pair<iterator,iterator> equal_range( const K& x );
(3) (C++20 起)
template< class K >
std::pair<iterator,iterator> equal_range( const K& x, std::size_t hash );
(3) (C++20 起)
template< class K >
std::pair<const_iterator,const_iterator> equal_range( const K& x ) const;
(4) (C++20 起)
template< class K >

std::pair<const_iterator,const_iterator> equal_range( const K& x,

                                                      std::size_t hash ) const;
(4) (C++20 起)
1,2) 返回容器中所有键等于 key 的元素范围。范围以二个迭代器定义,第一个指向所需范围的首元素,而第二个指向范围的尾后一位元素。
3,4) 返回含有容器中所有键等价于 x 的元素的范围。此重载仅若有限定 Hash::transparent_key_equal 合法并指代类型才参与重载决议。这假设能用 KKey 类型一起调用这种 Hash ,还有其 key_equal 是通透的,进而允许不用构造 Key 的实例就调用此函数。

hash 参数存在,则可用它传递计算好的哈希值,作为优化。若在传递的键上调用 hash_function() 产生的值与 hash 不同,则行为未定义。

(C++20 起)

目录

[编辑] 参数

key - 要与元素比较的键值
x - 任何能与键通透比较的类型的值
hash - 键的哈希值

[编辑] 返回值

含一对定义所需范围的迭代器的 std::pair 。若无这种元素,则将尾后(见 end() )迭代器作为 pair 的两个元素返回。

[编辑] 复杂度

平均情况与带关键 key 的元素数成线性,最坏情况与容器大小成线性。

[编辑] 示例

#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

[编辑] 参阅

寻找带有特定键的元素
(公开成员函数) [编辑]