Biblioteca de mapas C ++ - função equal_range ()

Descrição

A função C ++ std::multimap::equal_range() retorna um intervalo de elementos que correspondem à chave específica.

O intervalo é definido por dois iteradores, um aponta para o primeiro elemento que não é menor que a chave k e outro aponta para o primeiro elemento maior que a chave k .

Declaração

A seguir está a declaração para o cabeçalho da função std :: multimap :: equal_range () std :: map.

C ++ 98

pair<const_iterator,const_iterator> equal_range (const key_type& k) const;
pair<iterator,iterator>             equal_range (const key_type& k);

Parâmetros

k - Chave a ser pesquisada.

Valor de retorno

Se o objeto for qualificado constante, o método retorna um par de iterador constante, caso contrário, um par de iterador não constante.

Exceções

Nenhum efeito no contêiner se a exceção for lançada.

Complexidade de tempo

Logarítmico, ou seja, O (log n)

Exemplo

O exemplo a seguir mostra o uso da função std :: multimap :: equal_range ().

#include <iostream>
#include <map>

using namespace std;

int main(void) {
   multimap<char, int> m = {
      {'a', 1},
      {'b', 2},
      {'b', 3},
      {'b', 4},
      {'d', 5}
        };

   auto ret = m.equal_range('b');

   cout << "Elements associated with key 'b': ";

   for (auto it = ret.first; it != ret.second; ++it)
      cout << it->second << " ";
   cout << endl;

   return 0;
}

Vamos compilar e executar o programa acima, isso produzirá o seguinte resultado -

Elements associated with key 'b': 2 3 4