unordered_multimap::emplace
Inserts an element constructed in place (no copy or move operations are performed), with a placement hint.
template<class... Args>
iterator emplace(
Args&&... args);
Parameters
Parameter |
Description |
args |
The arguments forwarded to construct an element to be inserted into the unordered_multimap. |
Return Value
An iterator to the newly inserted element.
Remarks
No references to container elements are invalidated by this function, but it may invalidate all iterators to the container.
The value_type of an element is a pair, so that the value of an element will be an ordered pair with the first component equal to the key value and the second component equal to the data value of the element.
During the insertion, if an exception is thrown but does not occur in the container's hash function, the container is not modified. If the exception is thrown in the hash function, the result is undefined.
For a code example, see multimap::emplace.
Requirements
Header: <map>
Namespace: std