std::set equal_range() 方法

自 C++14 起

// (1) Non const version
std::pair<iterator, iterator> equal_range( const Key& key );

// (2) Const version
std::pair<const_iterator, const_iterator> equal_range( const Key& key ) const;

// (3) Non const version
template< class K >
std::pair<iterator, iterator> equal_range( const K& x );

// (4) Const version
template< class K >
std::pair<const_iterator, const_iterator> equal_range( const K& x ) const;

直到 C++14

// (1) Non const version
std::pair<iterator, iterator> equal_range( const Key& key );

// (2) Const version
std::pair<const_iterator, const_iterator> equal_range( const Key& key ) const;

返回一个包含容器中所有给定键的元素的范围。

该范围由两个迭代器定义，一个指向**不小于键的第一个元素**，另一个指向**大于键的第一个元素**。或者，第一个迭代器可以通过lower_bound()获得，第二个迭代器可以通过upper_bound()获得。

• (1-2) 将键与 key 进行比较。
• (3-4) 将键与值 x 进行比较。此重载仅在限定 ID Compare::is_transparent 有效且表示一个类型时才参与重载解析。它允许在不构造 Key 实例的情况下调用此函数。

参数

• key - 用于与元素比较的键值
• x - 可以与 Key 比较的替代值

返回值

std::pair 包含一对迭代器，定义所需的范围：第一个指向**不小于键的第一个元素**，第二个指向**大于键的第一个元素**。

如果不存在此类元素，则返回 past-the-end（参见end()）迭代器作为对的两个元素。

复杂度

对容器大小呈对数关系 - O(log size())。

异常

(无)

备注

特性测试宏：__cpp_lib_generic_unordered_lookup（用于重载 (3-4)）。

示例

Main.cpp

#include <set>
#include <iostream>
 
template <typename I>
void print_equal_range(I first, I lb, I ub, I last) {
    for (I i{first}; i != lb; ++i)
        std::cout << *i << " ";
    std::cout << "[ ";
    for (I i{lb}; i != ub; ++i)
        std::cout << *i << " ";
    std::cout << ") ";
    for (I i{ub}; i != last; ++i)
        std::cout << *i << " ";
    std::cout << '\n';
}
 
int main()
{
    std::set<int> c{4, 3, 2, 1, 3, 3};
    std::cout << "c = ";
    print_equal_range(begin(c), begin(c), end(c), end(c));
    for (int key{}; key != 6; ++key) {
        std::cout << "key = " << key << "; equal range = ";
        const auto [lb, ub] = c.equal_range(key);
        print_equal_range(begin(c), lb, ub, end(c));
    }
}

输出

c = [ 1 2 3 4 )
key = 0; equal range = [ ) 1 2 3 4
key = 1; equal range = [ 1 ) 2 3 4
key = 2; equal range = 1 [ 2 ) 3 4
key = 3; equal range = 1 2 [ 3 ) 4
key = 4; equal range = 1 2 3 [ 4 )
key = 5; equal range = 1 2 3 4 [ )