std::deque::insert

From Cppreference

C++ Standard Library
Language Utilities library Strings library Containers library Algorithms library Iterators library Numerics library Input/output library Localizations library Regular expressions library (C++11) Atomic operations library (C++11) Thread support library (C++11)
Containers library
array (C++11) vector deque forward_list (C++11) list set multiset map multimap unordered_set (C++11) unordered_multiset (C++11) unordered_map (C++11) unordered_multimap (C++11) stack queue priority_queue
std::deque
Member functions deque::deque deque::~deque deque::operator= deque::assign deque::get_allocator Element access deque::front deque::back Iterators deque::begin deque::cbegin (C++11) deque::end deque::cend (C++11) deque::rbegin deque::crbegin (C++11) deque::rend deque::crend (C++11) Capacity deque::empty deque::size deque::max_size deque::shrink_to_fit Modifiers deque::clear deque::insert deque::emplace deque::erase deque::push_front deque::emplace_front deque::pop_front deque::push_back deque::emplace_back deque::pop_back deque::resize deque::swap

iterator insert( iterator pos, const T& value ); iterator insert( const_iterator pos, const T& value );	(1)	(until C++11) (since C++11)
iterator insert( const_iterator pos, T&& value );	(2)	(since C++11)
void insert( iterator pos, size_type count, const T& value ); iterator insert( const_iterator pos, size_type count, const T& value );	(3)	(until C++11) (since C++11)
template< class InputIterator > void insert( iterator pos, InputIterator first, InputIterator last); template< class InputIterator > iterator insert( const_iterator pos, InputIterator first, InputIterator last );	(4)	(until C++11) (since C++11)
iterator insert( const_iterator pos, std::initializer_list<T> ilist );	(5)	(since C++11)

Inserts elements to specified position in the container.

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

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

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

5) inserts elements from initializer list ilist.

All iterators are invalidated. References are invalidated too, unless pos == begin() or pos == end(), in which case they are not invalidated.

Contents 1 Parameters 2 Return value 3 Complexity 4 See also

[edit] Parameters

pos	-	element before 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 following the last inserted element.

[edit] Complexity

This section is incomplete

[edit] See also

emplace (C++11)	constructs element in-place (public member function)
push_front	inserts elements to the beginning (public member function)
push_back	inserts elements to the end (public member function)