std::forward_list<T,Allocator>::before_begin, cbefore_begin

iterator before_begin() noexcept;		(since C++11)
const_iterator before_begin() const noexcept;		(since C++11)
const_iterator cbefore_begin() const noexcept;		(since C++11)

Возвращает итератор на элемент перед первым элементом контейнера. Этот элемент используется как заполнитель, попытка доступа к нему приводит к неопределённому поведению. Единственные случаи использования — в функциях insert_after(), emplace_after(), erase_after(), splice_after() и операторе инкремента: инкрементирование итератора before-begin даёт точно такой же итератор, как полученный из begin()/cbegin().

Параметры

(нет)

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

Итератор на элемент перед первым элементом.

Сложность

Постоянная.

Пример

См. также

begincbegin	возвращает итератор к началу (public member function)
endcend	возвращает итератор к концу (public member function)

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