# 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` 的元素数成线性，最坏情况与容器大小成线性。

### 示例

对给定字符串估计字符频率。

    #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

### 参阅

find (C++11) | 寻找带有特定键的元素 (公开成员函数)
contains (C++20) | 检查容器是否含有带特定键的元素 (公开成员函数)
count (C++11) | 返回匹配特定键的元素数量 (公开成员函数)
equal_range | 返回匹配特定键值的元素范围 (函数模板)