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

Inserts a new element into the container by constructing it in-place with the given args .

Careful use of emplace allows the new element to be constructed while avoiding unnecessary copy or move operations. The constructor of the new element (i.e. std::pair<const Key, T>) is called with exactly the same arguments as supplied to emplace, forwarded via std::forward<Args>(args)....

Information on iterator invalidation is copied from here


[edit] Parameters

args - arguments to forward to the constructor of the element

[edit] Return value

Returns an iterator to the inserted element.

[edit] Exceptions

If an exception is thrown by any operation, this function has no effect.

[edit] Complexity

Amortized constant on average, worst case linear in the size of the container.

[edit] Example

[edit] See also

constructs elements in-place using a hint
(public member function of std::{{{1}}}) [edit]
inserts elements
(public member function of std::{{{1}}}) [edit]