[#BloombergLP-bdlc-FlatHashTable-emplace]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlc.adoc[bdlc]::xref:BloombergLP/bdlc/FlatHashTable.adoc[FlatHashTable]::emplace
:relfileprefix: ../../../
:mrdocs:

Emplace an `ENTRY` constructed from `args` into this table.

== Synopsis

Declared in `<bdlc_flathashtable.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class... ARGS>
xref:bsl/pair-0b.adoc[bsl::pair<FlatHashTable<KEY, ENTRY, ENTRY_UTIL, HASH, EQUAL>::iterator, bool>]
emplace(ARGS&&... args);
----

== Description

Create an `ENTRY` object from the specified `args`, and attempt to add it to this flat hash table. Return a `bsl::pair` containing an iterator to the newly inserted object and `true` if the element was added. If an entry with the same key already exists in this flat hash table, return an iterator to that entry and `false`. This method requires that the `ENTRY` be `copy‐constructible`.

== Return Value

pair of iterator to the entry and whether insertion occurred

== Parameters

[cols="1,4"]
|===
| Name| Description
| *args*
| arguments forwarded to construct the entry
|===


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