list::front

Artigo
06/09/2015

Retorna uma referência ao primeiro elemento em uma lista.

reference front( );  const_reference front( ) const;

Valor de retorno

Se a lista estiver vazia, o retorno será indefinido.

Comentários

Se o valor de retorno de front for atribuído a const_reference, o objeto de lista não poderá ser modificado. Se o valor de retorno de front for atribuído a referência, o objeto de lista poderá ser modificado.

Ao compilar com _SECURE_SCL 1, ocorrerá um erro de tempo de execução se você tentar acessar um elemento em uma lista vazia. Consulte Iteradores Verificados para obter mais informações.

Exemplo

// list_front.cpp
// compile with: /EHsc
#include <list>
#include <iostream>

int main() {
   using namespace std;
   list <int> c1;

   c1.push_back( 10 );

   int& i = c1.front();
   const int& ii = c1.front();

   cout << "The first integer of c1 is " << i << endl;
   i++;
   cout << "The first integer of c1 is " << ii << endl;
}