[#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 pointer to the parameterized `TYPE` at the specified `address` whose value is unique for the specified `identifier`. 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.

== 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);
----


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