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.
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 . |
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.Exceptions
If an exception is thrown during insert_after
there are no effects (strong exception guarantee).
Complexity
1-2) Constant.
3) Linear in
count
4) Linear in
std::distance(first, last)
5) Linear in
ilist.size()
Example
See also
constructs elements in-place after an element (public member function) | |
inserts an element to the beginning (public member function) |
Please login to continue.