Biblioteca C ++ Forward_list - Função cbefore_begin ()

Descrição

A função C ++ std::forward_list::cbefore_begin() retorna um iterador de acesso aleatório constante que aponta para a posição antes do primeiro elemento de forward_list.

Este iterador pode ser usado com emplace_after , erase_after , insert_after e splice_after .

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 :: forward_list do formulário de função std :: forward_list :: cbefore_begin ().

C ++ 11

const_iterator cbefore_begin() const noexcept;

Parâmetros

Nenhum

Valor de retorno

Retorna um iterador de acesso aleatório 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 :: forward_list :: cbefore_begin ().

#include <iostream>
#include <forward_list>

using namespace std;

int main(void) {

   forward_list<int> fl = {2, 3, 4, 5};
   auto it = fl.cbefore_begin();

   fl.insert_after(it, 1);

   cout << "List contains following elements" << endl;

   for (auto it = fl.begin(); it != fl.end(); ++it)
      cout << *it << endl;

   return 0;
}

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

List contains following elements
1
2
3
4
5