Emplace a newly constructed element into this container.

Synopsis

Declared in <bslstl_unorderedmultimap.h>

template<class... Args>
unordered_multimap<KEY, VALUE, HASH, EQUAL, ALLOCATOR>::iterator
emplace(Args&&... args);

Description

Insert into this unordered multimap a newly created value_type object, constructed by forwarding get_allocator() (if required) and the specified (variable number of) args to the corresponding constructor of value_type. Return an iterator referring to the newly created and inserted object in this unordered multimap. This method requires that the (template parameter) types KEY and VALUE both be emplace‐constructible from args (see {Requirements on KEY and VALUE}).

Return Value

iterator referring to the newly inserted element

Parameters

Name

Description

args

constructor arguments for the new element

Created with MrDocs