[#BloombergLP-bsltf-TemplateTestFacility-emplace-0e]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bsltf.adoc[bsltf]::xref:BloombergLP/bsltf/TemplateTestFacility.adoc[TemplateTestFacility]::emplace
:relfileprefix: ../../../
:mrdocs:

Create a `TYPE` pointer at `address` unique for `identifier`&period;

== Synopsis

Declared in `&lt;bsltf&lowbar;templatetestfacility&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;
    class TYPE,
    class ALLOCATOR&gt;
static
void
emplace(
    TYPE** address,
    int identifier,
    ALLOCATOR allocator);
----

== Description

The behavior is undefined unless `0 &lt;&equals; identifier &lt; 128`&period; Note that no object is created at the address of the returned pointer, nor is it guaranteed to be a valid address for an object (or function)&period; Also note that the same address may be returned for different allocators, and is guaranteed to be unique only with respect to the `identifier` value&period;

== Parameters

[cols="1,4"]
|===
| Name| Description
| *address*
| storage for the pointer value
| *identifier*
| integer identity encoded as a pointer value
| *allocator*
| unused allocator argument
|===


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