std::forward_list::insert_after
From cppreference.com
< cpp | container | forward list
| iterator insert_after( const_iterator pos, const T& value );
|
(1) | (since C++11) |
| iterator insert_after( const_iterator pos, T&& value );
|
(2) | (since C++11) |
| iterator insert_after( const_iterator pos, size_type count, const T& value );
|
(3) | (since C++11) |
| template< class InputIt >
iterator insert_after( const_iterator pos, InputIt first, InputIt last ); |
(4) | (since C++11) |
| iterator insert_after( const_iterator pos, std::initializer_list<T> ilist );
|
(5) | (since C++11) |
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.
The behavior is undefined if first and last are iterators into *this.
5) inserts elements from initializer list
ilist.No iterators or references 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 |
| Type requirements | ||
-
InputIt must meet the requirements of InputIterator.
|
||
[edit] Return value
1-2) Iterator to the inserted element.
3) Iterator to the last element inserted, or
pos if count==0.
4) Iterator to the last element inserted, or
pos if first==last.
5) Iterator to the last element inserted, or
pos if ilist is empty.[edit] Exceptions
If an exception is thrown during insert_after there are no effects (strong exception guarantee).
[edit] Complexity
1-2) Constant.
3) Linear in count
4) Linear in std::distance(first, last)
5) Linear in ilist.size()
[edit] Example
| This section is incomplete Reason: no example |
[edit] See also
| constructs elements in-place after an element (public member function) |
|
| inserts elements to the beginning (public member function) |