std::flat_multiset<Key,Compare,KeyContainer>::equal_range

std::pair<iterator, iterator> equal_range( const Key& key );

std::pair<const_iterator, const_iterator> equal_range( const Key& key ) const;

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

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

Возвращает диапазон, содержащий все элементы контейнера с заданным ключом. Диапазон определяется двумя итераторами: один указывает на первый элемент, который не меньше key, а другой — на первый элемент, больший key. В качестве альтернативы первый итератор можно получить с помощью lower_bound(), а второй — с помощью upper_bound().

Параметры

Возвращаемое значение

std::pair, содержащая пару итераторов, задающих нужный диапазон: первый указывает на первый элемент, который не меньше key, а второй — на первый элемент, больший key.

Если элементов, которые не меньше key, нет, в качестве первого элемента возвращается итератор за последним элементом (см. end()). Аналогично, если элементов, больших key, нет, в качестве второго элемента возвращается итератор за последним элементом.

Поскольку emplace и вставка без подсказки с помощью insert всегда выполняются в верхнюю границу, порядок эквивалентных элементов в диапазоне равных значений совпадает с порядком вставки, если только для вставки элемента в другую позицию не использовались вставка с подсказкой insert или emplace_hint.

Сложность

Логарифмическая относительно размера контейнера.

Пример

#include <iostream>
#include <flat_set>

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::flat_multiset<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 3 3 4 )
key = 0; equal range = [ ) 1 2 3 3 3 4
key = 1; equal range = [ 1 ) 2 3 3 3 4
key = 2; equal range = 1 [ 2 ) 3 3 3 4
key = 3; equal range = 1 2 [ 3 3 3 ) 4
key = 4; equal range = 1 2 3 3 3 [ 4 )
key = 5; equal range = 1 2 3 3 3 4 [ )

См. также