Difference between revisions of "Template:cpp/container/insert"
From cppreference.com
D41D8CD98F (Talk | contribs) m (Example is special for vector) |
|||
| Line 97: | Line 97: | ||
| {{included}} | | {{included}} | ||
}} | }} | ||
| − | + | {{#switch:{{{1|}}} | |
| + | |vector= | ||
===Example=== | ===Example=== | ||
{{example | {{example | ||
| Line 142: | Line 143: | ||
501 502 503 300 300 400 400 200 100 100 100 | 501 502 503 300 300 400 400 200 100 100 100 | ||
}} | }} | ||
| − | + | }} | |
===See also=== | ===See also=== | ||
{{dsc begin}} | {{dsc begin}} | ||
Revision as of 03:53, 21 January 2014
| (1) | ||
| iterator insert( iterator pos, const T& value ); |
(until C++11) | |
| iterator insert( const_iterator pos, const T& value ); |
(since C++11) | |
| iterator insert( const_iterator pos, T&& value ); |
(2) | (since C++11) |
| (3) | ||
| void insert( iterator pos, size_type count, const T& value ); |
(until C++11) | |
| iterator insert( const_iterator pos, size_type count, const T& value ); |
(since C++11) | |
| (4) | ||
| template< class InputIt > void insert( iterator pos, InputIt first, InputIt last); |
(until C++11) | |
| template< class InputIt > iterator insert( const_iterator pos, InputIt first, InputIt last ); |
(since C++11) | |
| iterator insert( const_iterator pos, std::initializer_list<T> ilist ); |
(5) | (since C++11) |
Inserts elements at specified position in the container.
1-2) inserts
value before the element pointed to by pos3) inserts
count copies of the value before the element pointed to by pos4) inserts elements from range
[first, last) before 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.| Information on iterator invalidation is copied from here |
Contents |
Parameters
| pos | - | element before which the content will be inserted |
| value | - | element value to insert |
| first, last | - | the range of elements to insert, can't be iterators into container for which insert is called |
| ilist | - | initializer list to insert the values from |
| Type requirements | ||
Return value
1-2) Iterator pointing to the inserted
value3) Iterator pointing to the first element inserted, or
pos if count==0.4) Iterator pointing to the first element inserted, or
pos if first==last.5) Iterator pointing to the first element inserted, or
pos if ilist is empty.Complexity
| Templated information. See page source. |
See also
| constructs element in-place (public member function of std::{{{1}}})
| |
| inserts an element to the beginning (public member function of std::{{{1}}})
| |
| adds an element to the end (public member function of std::{{{1}}})
|
