list::front

Artikel
06/09/2015

Gibt einen Verweis auf das erste Element in einer Liste zurück.

reference front( );  const_reference front( ) const;

Rückgabewert

Wenn die Liste leer ist, ist die Rückgabe nicht definiert.

Hinweise

Wenn front dem Rückgabewert von const_reference zugewiesen wird, kann das Listenobjekt nicht geändert werden. Wenn der Rückgabewert von front einem reference zugewiesen wird, kann das Listenobjekt geändert werden.

Beim Kompilieren mit _SECURE_SCL 1 tritt ein Laufzeitfehler auf, wenn Sie versuchen, auf ein Element in einer leeren Liste zuzugreifen. Weitere Informationen finden Sie unter Überprüfte Iteratoren.

Beispiel

// 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;
}