std::unordered_multimap::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::unordered_multimap
Member functions unordered_multimap::unordered_multimap unordered_multimap::~unordered_multimap unordered_multimap::operator= unordered_multimap::get_allocator Iterators unordered_multimap::begin unordered_multimap::cbegin unordered_multimap::end unordered_multimap::cend Capacity unordered_multimap::erase unordered_multimap::size unordered_multimap::max_size Modifiers unordered_multimap::clear unordered_multimap::insert unordered_multimap::emplace unordered_multimap::emplace_hint unordered_multimap::erase unordered_multimap::swap Lookup unordered_multimap::count unordered_multimap::find unordered_multimap::equal_range Bucket interface unordered_multimap::begin(int) unordered_multimap::end(int) unordered_multimap::bucket_count unordered_multimap::max_bucket_count unordered_multimap::bucket_size unordered_multimap::bucket Hash policy unordered_multimap::load_factor unordered_multimap::max_load_factor unordered_multimap::rehash unordered_multimap::reserve Observers unordered_multimap::hash_function unordered_multimap::key_eq

template <class... Args> iterator 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 type (value_type) is called as follows: the first argument is used to construct the key, the rest of the arguments are used to construct the value.

If rehashing occurs due to the insertion, all iterators are invalidated. Otherwise iterators are not affected. References are not invalidated.

This section is incomplete Reason: when rehashing occurs?

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 an iterator to the inserted element.

[edit] Complexity

This section is incomplete

[edit] See also

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