Spec-Zone.ru › C++

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

reference front();
(1)
const_reference front() const;
(2)

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

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

(до C++26)

Если empty() равно true:

  • Если реализация защищена, происходит нарушение контракта.
  • Если реализация не защищена, поведение не определено.
(начиная с 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');
}

См. также

back
доступ к последнему элементу
(открытая функция-член)
rendcrend
(C++11)
возвращает обратный итератор, указывающий на конец
(открытая функция-член)
begincbegin
(C++11)
возвращает итератор, указывающий на начало
(открытая функция-член)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/container/list/front

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API