[#BloombergLP-bdlb-NullableAllocatedValue-emplace-01]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlb.adoc[bdlb]::xref:BloombergLP/bdlb/NullableAllocatedValue.adoc[NullableAllocatedValue]::emplace
:relfileprefix: ../../../
:mrdocs:

`emplace` overloads

== Synopses

Declared in `<bdlb_nullableallocatedvalue.h>`

Assign to this object the value of the (template parameter) `TYPE` created in place using the specified `args` and return a reference providing modifiable access to the underlying `TYPE` object. If this `optional` object already contains an object (`true == hasValue()`), that object is destroyed before the new object is created. Note that if the constructor of `TYPE` throws an exception this object is left in a disengaged state.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class... ARGS>
TYPE&
xref:BloombergLP/bdlb/NullableAllocatedValue/emplace-07.adoc[emplace](ARGS&&... args);
----

[.small]#xref:BloombergLP/bdlb/NullableAllocatedValue/emplace-07.adoc[_» more..._]#

Assign to this object the value of the (template parameter) `TYPE` created in place using the specified `il` and specified `args` and return a reference providing modifiable access to the underlying `TYPE` object. If this object already contains an object (`true == hasValue()`), that object is destroyed before the new object is created. Note that if the constructor of `TYPE` throws an exception this object is left in a disengaged state.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<
    class INIT_LIST_TYPE,
    class... ARGS>
TYPE&
xref:BloombergLP/bdlb/NullableAllocatedValue/emplace-0e.adoc[emplace](
    std::initializer_list<INIT_LIST_TYPE> il,
    ARGS&&... args);
----

[.small]#xref:BloombergLP/bdlb/NullableAllocatedValue/emplace-0e.adoc[_» more..._]#


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