std::map::emplace

From Cppreference

Jump to: navigation, search
template <class... Args>
std::pair<iterator, bool> emplace_hint( const_iterator hint, Args&&... args );
(C++11 feature)

Inserts a new element to the container, using hint as a suggestion where the element should go. 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.

Contents

[edit] Parameters

hint - iterator, used as a suggestion as to where to insert the new element
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

[edit] See also

emplace (C++11)
constructs element in-place
(public member function)
insert
inserts elements
(public member function)