bsl::map::try_emplace

Try to emplace an element with key near hint.

Synopsis

Declared in <bslstl_map.h>

template<class... Args>
map<KEY, VALUE, COMPARATOR, ALLOCATOR>::iterator
try_emplace(
    const_iterator hint,
    KEY const& key,
    Args&&... args);

Description

If a key equivalent to the specified key already exists in this map, return an iterator referring to the existing item. Otherwise, insert into this map a newly-created value_type object, constructed from from key and the specified args, and return an iterator referring to the newly-created entry. Use the specified hint as a starting point for checking to see if the key already in the map. This method requires that the (template parameter) types KEY and VALUE are emplace-constructible from key and args respectively. For C++03, VALUE must also be copy-constructible.

Return Value

iterator to the existing or newly inserted element

Parameters

NameDescription
hintiterator hint for the insertion position
keykey for the element to emplace
argsconstructor arguments for the mapped value