[#bsl-list-054-emplace_back]
= xref:bsl.adoc[bsl]::xref:bsl/list-054.adoc[list]::emplace&lowbar;back
:relfileprefix: ../../
:mrdocs:

Append a newly constructed `value&lowbar;type` object to the back of this list&period;

== Synopsis

Declared in `&lt;bslstl&lowbar;list&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class&period;&period;&period; ARGS&gt;
xref:bsl/list-054/reference.adoc[list&lt;VALUE, ALLOCATOR&gt;::reference]
emplace&lowbar;back(ARGS&&&period;&period;&period; arguments);
----

== Description

The object is constructed by forwarding `get&lowbar;allocator()` (if required) and the specified (variable number of) `arguments` to the corresponding constructor of `value&lowbar;type`&period; Return a reference providing modifiable access to the inserted element&period; If an exception is thrown (other than by the move constructor of a non&hyphen;copy&hyphen;insertable `value&lowbar;type`), this method has no effect&period; This method requires that the (template parameter) `VALUE` be `move&hyphen;insertable` into this list and `emplace&hyphen;constructible` from `arguments` (see &lcub;Requirements on `VALUE`&rcub;)&period;

== Return Value

modifiable reference to the emplaced element

== Parameters

[cols="1,4"]
|===
| Name| Description
| *arguments*
| constructor arguments forwarded to `value&lowbar;type`
|===


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