[#BloombergLP-bdlma-LocalBufferedObject-emplace-09]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlma.adoc[bdlma]::xref:BloombergLP/bdlma/LocalBufferedObject.adoc[LocalBufferedObject]::emplace
:relfileprefix: ../../../
:mrdocs:

Replace the held object with one constructed from `il`&period;

== Synopsis

Declared in `&lt;bdlma&lowbar;localbufferedobject&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class INIT&lowbar;LIST&lowbar;TYPE&gt;
void
emplace(std::initializer&lowbar;list&lt;INIT&lowbar;LIST&lowbar;TYPE&gt; il);
----

== Description

Destroy the `value&lowbar;type` object unless `t&lowbar;DISABLE&lowbar;DESTRUCTION` is true, then release all allocated memory, the re&hyphen;construct a new `value&lowbar;type` object using the specified `il` and using the sequential allocator based on the local stack buffer&period;

== Parameters

[cols="1,4"]
|===
| Name| Description
| *il*
| initializer list used to construct the new held object
|===


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