[#bsl-priority_queue-034-emplace]
= xref:bsl.adoc[bsl]::xref:bsl/priority_queue-034.adoc[priority&lowbar;queue]::emplace
:relfileprefix: ../../
:mrdocs:

Emplace a newly constructed element into this priority queue&period;

== Synopsis

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

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class&period;&period;&period; Args&gt;
void
emplace(Args&&&period;&period;&period; args);
----

== Description

Insert into this priority queue a newly created `value&lowbar;type` object, constructed by forwarding the specified (variable number of) `args` to the corresponding constructor of `value&lowbar;type`&period; In effect, performs `c&period;emplace&lowbar;back(FORWARD(Args,args)&period;&period;&period;)&semi;`&period;

== Parameters

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


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