list::front

Статья
06/09/2015

Возвращает ссылку на первый элемент в списке.

reference front( );  const_reference front( ) const;

Возвращаемое значение

Если список пуст, возвращаемое значение не определено.

Заметки

Если возвращаемое значение front назначается const_reference, то объект списка невозможно изменить. Если возвращаемое значение front назначается ссылке, то объект списка можно изменить.

При компиляции с параметром _SECURE_SCL 1 возникнет ошибка времени выполнения при попытке доступа к элементу в пустом списке. Дополнительные сведения см. в разделе Проверяемые итераторы.

Пример

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