Namespaces
Variants

std::list<T,Allocator>:: front

From cppreference.net

C++
Containers library
std::list
Member functions
Non-member functions
(until C++20) (until C++20) (until C++20) (until C++20) (until C++20)
Deduction guides (C++17)
reference front ( ) ;
(1) (constexpr начиная с C++26)
const_reference front ( ) const ;
(2) (constexpr начиная с C++26)

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

Если empty() возвращает true , поведение не определено.

(до C++26)

Если empty() возвращает true :

  • Если реализация защищённая (hardened) , происходит нарушение контракта (contract violation) . Более того, если обработчик нарушения контракта возвращает управление при семантике оценки "observe", поведение не определено.
  • Если реализация не защищённая, поведение не определено.
(начиная с C++26)

Содержание

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

Ссылка на первый элемент.

Сложность

Константа.

Примечания

Для контейнера c выражение c. front ( ) эквивалентно * c. begin ( ) .

Пример

Следующий код использует front для отображения первого элемента std:: list < char > :

Запустить этот код 
#include <cassert>
#include <list>
int main()
{
    std::list<char> letters{'a', 'b', 'c', 'd'};
    assert(letters.front() == 'a');
}

Смотрите также

доступ к последнему элементу
(public member function)
(C++11)
возвращает обратный итератор на конец
(public member function)
(C++11)
возвращает итератор на начало
(public member function)