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

Descrição

A função C ++ std::multimap::begin() retorna um iterador que se refere ao primeiro elemento do multimapa.

Declaração

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

C ++ 98

iterator begin();
const_iterator begin() const;

C ++ 11

iterator begin() noexcept;
const_iterator begin() const noexcept;

Parâmetros

Nenhum

Valor de retorno

Se o objeto é qualificado por constante, o método retorna um iterador constante, caso contrário, ele retorna uma referência não constante.

Exceções

Esta função de membro nunca lança exceção.

Complexidade de tempo

Constante, ou seja, O (1)

Exemplo

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

#include <iostream>
#include <map>

using namespace std;

int main(void) {
   /* Multimap with duplicates */
   multimap<char, int> m {
         {'a', 1},
         {'a', 2},
         {'b', 3},
         {'c', 4},
         {'c', 5},
               };

   cout << "Multimap contains following elements:" << endl;

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

   return 0;
}

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

Multimap contains following elements:
a = 1
a = 2
b = 3
c = 4
c = 5