std::vector::emplace

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::vector
Member functions vector::vector vector::~vector vector::operator= vector::assign vector::get_allocator Element access vector::at vector::operator[] vector::front vector::back vector::data Iterators vector::begin vector::cbegin (C++11) vector::end vector::cend (C++11) vector::rbegin vector::crbegin (C++11) vector::rend vector::crend (C++11) Capacity vector::empty vector::size vector::max_size vector::reserve vector::capacity vector::shrink_to_fit (C++11) Modifiers vector::clear vector::insert vector::emplace (C++11) vector::erase vector::push_back vector::emplace_back (C++11) vector::pop_back vector::resize vector::swap

template< class... Args > iterator emplace( const_iterator pos, Args&&... args );		(since C++11)

Inserts a new element to the specified position in the container. The element is constructed in-place, i.e. no copy or move operations are performed. The constructor of the element is called with exactly the same arguments, as supplied to the function.

Iterators and references to the elements between pos and the end of the container are invalidated.

Contents 1 Parameters 2 Return value 3 Complexity 4 See also

[edit] Parameters

pos	-	iterator before which the new element will be constructed
args	-	arguments to forward to the constructor of the element

[edit] Return value

iterator following the emplaced element.

[edit] Complexity

This section is incomplete

[edit] See also

insert	inserts elements (public member function)