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

Descrição

A função C ++ std::forward_list::before_begin() retorna um iterador de acesso aleatório 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 .

Declaração

A seguir está a declaração para o cabeçalho std :: forward_list do formulário de função std :: forward_list :: before_begin ().

C ++ 11

iterator before_begin() noexcept;
const_iterator before_begin() const noexcept;

Parâmetros

Nenhum

Valor de retorno

Se o objeto forward_list for qualificado constante, o método retorna um iterador de acesso aleatório constante, caso contrário, um iterador de acesso aleatório 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 :: forward_list :: before_begin ().

#include <iostream>
#include <forward_list>

using namespace std;

int main(void) {

   forward_list<int> fl = {2, 3, 4, 5};
   auto it = fl.before_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