std::forward_list::insert_after

From Cppreference

Jump to: navigation, search
iterator insert_after( const_iterator pos, const T& value );
(1) (C++11 feature)
iterator insert_after( const_iterator pos, T&& value );
(2) (C++11 feature)
iterator insert_after( const_iterator pos, size_type count, const T& value );
(3) (C++11 feature)
template< class InputIterator >
iterator insert_after( const_iterator pos, InputIterator first, InputIterator last );
(4) (C++11 feature)
iterator insert_after( const_iterator pos, std::initializer_list<T> ilist );
(5) (C++11 feature)

Inserts elements after the specified position in the container.

1-2) inserts value after the element pointed to by pos

3) inserts count copies of the value after the element pointed to by pos

4) inserts elements from range [first, last) after the element pointed to by pos

5) inserts elements from initializer list ilist.

No references or iterators are invalidated.

Contents

[edit] Parameters

pos - element after which the content will be inserted
value - element value to insert
first, last - the range of elements to insert
ilist - initializer list to insert the values from

[edit] Return value

iterator to the inserted element.

[edit] Complexity

[edit] See also

emplace_after
constructs elements in-place after an element
(public member function)
push_front
inserts elements to the beginning
(public member function)