Syntaxe:

    #include <list>
    iterator end();
    const_iterator end() const;

A função end() retorna um iterador apontando para um elemento logo após ao último elemento da lista.

Note que, para que você possa acessar o último elemento da lista usando um iterador obtido chamando end(), é necessário antes decrementar o iterador.

Por exemplo, o código a seguir usa begin() e end() para percorrer todos os elementos de uma lista:

   list<int> v1( 5, 789 );
   list<int>::iterator it;
   for( it = v1.begin(); it != v1.end(); it++ ) {
     cout << *it << endl;
   }

O iterador é inicializado chamando-se begin(). Depois que o corpo do loop é executado, o iterador é incrementado e testado para ver se é igual ao resultado da chamada end(). Como end() retorna um iterador que aponta para depois do último elemento, a execuçãao sairá do loop quando todos os elementos tiverem sido percorridos.

end() executa em tempo constante.

Tópicos relacionados: begin, rbegin, rend