[#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`.

== Synopsis

Declared in `<bsltf_templatetestfacility.h>`

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

== Description

The behavior is undefined unless `0 <= identifier < 128`. 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). 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.

== 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]#