std::set::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::set
Member functions set::set set::~set set::operator= set::get_allocator Iterators set::begin set::cbegin (C++11) set::end set::cend (C++11) set::rbegin set::crbegin (C++11) set::rend set::crend (C++11) Capacity set::empty set::size set::max_size Modifiers set::clear set::insert set::emplace (C++11) set::emplace_hint (C++11) set::erase set::swap Lookup set::count set::find set::equal_range set::lower_bound set::upper_bound Observers set::key_comp set::value_comp

template <class... Args> std::pair<iterator, bool> emplace( Args&&... args );		(since C++11)

Inserts a new element to 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.

No iterators or references are invalidated.

Contents 1 Parameters 2 Return value 3 Complexity 4 See also

[edit] Parameters

args

-

arguments to forward to the constructor of the element

[edit] Return value

returns a pair consisting of a bool denoting whether the insertion took place and an iterator to the inserted element.

[edit] Complexity

This section is incomplete

[edit] See also

emplace_hint (C++11)	constructs elements in-place using a hint (public member function)
insert	inserts elements (public member function)