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

Descrição

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

O iterador obtido por esta função de membro pode ser usado para iterar o contêiner, mas não pode ser usado para modificar o conteúdo do objeto para o qual está apontando, mesmo se o próprio objeto não for constante.

Declaração

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

C ++ 11

const_iterator cbegin() const noexcept;

Parâmetros

Nenhum

Valor de retorno

Retorna o iterador 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 :: cbegin ().

#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.cbegin(); it != m.cend(); ++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