[#nlohmann-ordered_map-emplace-0b]
= xref:nlohmann.adoc[nlohmann]::xref:nlohmann/ordered_map.adoc[ordered_map]::emplace
:relfileprefix: ../../
:mrdocs:

inserts a new element constructed from _key_ and _t_ if the key does not already exist

== Synopsis

Declared in `<nlohmann/ordered_map.hpp>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class KeyType>
requires detail::is_usable_as_key_type<key_compare, key_type, KeyType>::value
std::pair<iterator, bool>
emplace(
    KeyType&& key,
    T&& t);
----

== Return Value

pair of an iterator to the (possibly pre‐existing) element and a bool that is true if the insertion took place

== Parameters

[cols="1,4"]
|===
| Name| Description
| *key* [in]
| key of the element to insert
| *t* [in]
| value of the element to insert
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#