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

`emplace` overloads

== Synopses

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

Create an `AllocEmplacableTestType` at `address` from `identifier`&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class ALLOCATOR&gt;
static
void
xref:BloombergLP/bsltf/TemplateTestFacility/emplace-08.adoc[emplace](
    xref:BloombergLP/bsltf/AllocEmplacableTestType.adoc[AllocEmplacableTestType]* address,
    int identifier,
    ALLOCATOR allocator);
----

[.small]#xref:BloombergLP/bsltf/TemplateTestFacility/emplace-08.adoc[_» more&period;&period;&period;_]#

Same as the preceding overload taking an allocator pointer&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class ALLOCATOR&gt;
static
void
xref:BloombergLP/bsltf/TemplateTestFacility/emplace-04d.adoc[emplace](
    xref:BloombergLP/bsltf/AllocEmplacableTestType.adoc[AllocEmplacableTestType]* address,
    int identifier,
    ALLOCATOR* allocator);
----

[.small]#xref:BloombergLP/bsltf/TemplateTestFacility/emplace-04d.adoc[_» more&period;&period;&period;_]#

Create an `EmplacableTestType` at `address` from `identifier`&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class ALLOCATOR&gt;
static
void
xref:BloombergLP/bsltf/TemplateTestFacility/emplace-0b3.adoc[emplace](
    xref:BloombergLP/bsltf/EmplacableTestType.adoc[EmplacableTestType]* address,
    int identifier,
    ALLOCATOR allocator);
----

[.small]#xref:BloombergLP/bsltf/TemplateTestFacility/emplace-0b3.adoc[_» more&period;&period;&period;_]#

Same as the preceding overload taking an allocator pointer&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class ALLOCATOR&gt;
static
void
xref:BloombergLP/bsltf/TemplateTestFacility/emplace-0cf.adoc[emplace](
    xref:BloombergLP/bsltf/EmplacableTestType.adoc[EmplacableTestType]* address,
    int identifier,
    ALLOCATOR* allocator);
----

[.small]#xref:BloombergLP/bsltf/TemplateTestFacility/emplace-0cf.adoc[_» more&period;&period;&period;_]#

Set the enumeration at the specified `address` to the value of the specified `identifier`&period; The specified `allocator` is not used&period; The behavior is undefined unless `0 &lt;&equals; identifier &lt; 128`&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class ALLOCATOR&gt;
static
void
xref:BloombergLP/bsltf/TemplateTestFacility/emplace-042e.adoc[emplace](
    xref:BloombergLP/bsltf/EnumeratedTestType/Enum.adoc[EnumeratedTestType::Enum]* address,
    int identifier,
    ALLOCATOR allocator);
----

[.small]#xref:BloombergLP/bsltf/TemplateTestFacility/emplace-042e.adoc[_» more&period;&period;&period;_]#

Same as the preceding overload taking an allocator pointer&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class ALLOCATOR&gt;
static
void
xref:BloombergLP/bsltf/TemplateTestFacility/emplace-03e.adoc[emplace](
    xref:BloombergLP/bsltf/EnumeratedTestType/Enum.adoc[EnumeratedTestType::Enum]* address,
    int identifier,
    ALLOCATOR* allocator);
----

[.small]#xref:BloombergLP/bsltf/TemplateTestFacility/emplace-03e.adoc[_» more&period;&period;&period;_]#

Set the pointer&hyphen;to&hyphen;method at the specified `address` to the value of the specified `identifier`&period; The specified `allocator` is not used&period; The behavior is undefined unless `0 &lt;&equals; identifier &lt; 128`&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class ALLOCATOR&gt;
static
void
xref:BloombergLP/bsltf/TemplateTestFacility/emplace-0a.adoc[emplace](
    xref:BloombergLP/bsltf/TemplateTestFacility/MethodPtr.adoc[MethodPtr]* address,
    int identifier,
    ALLOCATOR allocator);
----

[.small]#xref:BloombergLP/bsltf/TemplateTestFacility/emplace-0a.adoc[_» more&period;&period;&period;_]#

Same as the preceding overload taking an allocator pointer&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class ALLOCATOR&gt;
static
void
xref:BloombergLP/bsltf/TemplateTestFacility/emplace-0c0.adoc[emplace](
    xref:BloombergLP/bsltf/TemplateTestFacility/MethodPtr.adoc[MethodPtr]* address,
    int identifier,
    ALLOCATOR* allocator);
----

[.small]#xref:BloombergLP/bsltf/TemplateTestFacility/emplace-0c0.adoc[_» more&period;&period;&period;_]#

Set the character object at the specified `address` to the value of the specified `identifier`&period; The specified `allocator` is not used&period; The behavior is undefined unless `0 &lt;&equals; identifier &lt; 128`&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class ALLOCATOR&gt;
static
void
xref:BloombergLP/bsltf/TemplateTestFacility/emplace-030.adoc[emplace](
    char* address,
    int identifier,
    ALLOCATOR allocator);
----

[.small]#xref:BloombergLP/bsltf/TemplateTestFacility/emplace-030.adoc[_» more&period;&period;&period;_]#

Same as the preceding overload taking an allocator pointer&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class ALLOCATOR&gt;
static
void
xref:BloombergLP/bsltf/TemplateTestFacility/emplace-09.adoc[emplace](
    char* address,
    int identifier,
    ALLOCATOR* allocator);
----

[.small]#xref:BloombergLP/bsltf/TemplateTestFacility/emplace-09.adoc[_» more&period;&period;&period;_]#

Same as the related overload for `signed char`&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class ALLOCATOR&gt;
static
void
xref:BloombergLP/bsltf/TemplateTestFacility/emplace-00.adoc[emplace](
    signed char* address,
    int identifier,
    ALLOCATOR allocator);
----

[.small]#xref:BloombergLP/bsltf/TemplateTestFacility/emplace-00.adoc[_» more&period;&period;&period;_]#

Same as the preceding overload taking an allocator pointer&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class ALLOCATOR&gt;
static
void
xref:BloombergLP/bsltf/TemplateTestFacility/emplace-0cd.adoc[emplace](
    signed char* address,
    int identifier,
    ALLOCATOR* allocator);
----

[.small]#xref:BloombergLP/bsltf/TemplateTestFacility/emplace-0cd.adoc[_» more&period;&period;&period;_]#

Same as the related overload for `unsigned char`&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class ALLOCATOR&gt;
static
void
xref:BloombergLP/bsltf/TemplateTestFacility/emplace-044.adoc[emplace](
    unsigned char* address,
    int identifier,
    ALLOCATOR allocator);
----

[.small]#xref:BloombergLP/bsltf/TemplateTestFacility/emplace-044.adoc[_» more&period;&period;&period;_]#

Same as the preceding overload taking an allocator pointer&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class ALLOCATOR&gt;
static
void
xref:BloombergLP/bsltf/TemplateTestFacility/emplace-0b6.adoc[emplace](
    unsigned char* address,
    int identifier,
    ALLOCATOR* allocator);
----

[.small]#xref:BloombergLP/bsltf/TemplateTestFacility/emplace-0b6.adoc[_» more&period;&period;&period;_]#

Create at the specified `address` a pointer to a null&hyphen;terminated string that will parse as having the same value as the specified `identifier`&period; The specified `allocator` is not used&period; The behavior is undefined unless `0 &lt;&equals; identifier &lt; 128`&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class ALLOCATOR&gt;
static
void
xref:BloombergLP/bsltf/TemplateTestFacility/emplace-06.adoc[emplace](
    char const** address,
    int identifier,
    ALLOCATOR allocator);
----

[.small]#xref:BloombergLP/bsltf/TemplateTestFacility/emplace-06.adoc[_» more&period;&period;&period;_]#

Same as the preceding overload taking an allocator pointer&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class ALLOCATOR&gt;
static
void
xref:BloombergLP/bsltf/TemplateTestFacility/emplace-0c83.adoc[emplace](
    char const** address,
    int identifier,
    ALLOCATOR* allocator);
----

[.small]#xref:BloombergLP/bsltf/TemplateTestFacility/emplace-0c83.adoc[_» more&period;&period;&period;_]#

Create an object of the parameterized `TYPE` at the specified `address` whose state is unique for the specified `identifier`&period; The behavior is undefined unless `0 &lt;&equals; identifier &lt; 128` and `TYPE` is contained in the macro `BSLTF&lowbar;TEMPLATETESTFACILITY&lowbar;TEST&lowbar;TYPES&lowbar;ALL`&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;
    class TYPE,
    class ALLOCATOR&gt;
static
void
xref:BloombergLP/bsltf/TemplateTestFacility/emplace-0f.adoc[emplace](
    TYPE* address,
    int identifier,
    ALLOCATOR allocator);
----

[.small]#xref:BloombergLP/bsltf/TemplateTestFacility/emplace-0f.adoc[_» more&period;&period;&period;_]#

Same as the preceding overload taking an allocator pointer&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;
    class TYPE,
    class ALLOCATOR&gt;
static
void
xref:BloombergLP/bsltf/TemplateTestFacility/emplace-05.adoc[emplace](
    TYPE* address,
    int identifier,
    ALLOCATOR* allocator);
----

[.small]#xref:BloombergLP/bsltf/TemplateTestFacility/emplace-05.adoc[_» more&period;&period;&period;_]#

Create a pointer to the parameterized `TYPE` at the specified `address` whose value is unique for the specified `identifier`&period; 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;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;
    class TYPE,
    class ALLOCATOR&gt;
static
void
xref:BloombergLP/bsltf/TemplateTestFacility/emplace-0e.adoc[emplace](
    TYPE** address,
    int identifier,
    ALLOCATOR allocator);
----

[.small]#xref:BloombergLP/bsltf/TemplateTestFacility/emplace-0e.adoc[_» more&period;&period;&period;_]#

Same as the preceding overload taking an allocator pointer&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;
    class TYPE,
    class ALLOCATOR&gt;
static
void
xref:BloombergLP/bsltf/TemplateTestFacility/emplace-0c81.adoc[emplace](
    TYPE** address,
    int identifier,
    ALLOCATOR* allocator);
----

[.small]#xref:BloombergLP/bsltf/TemplateTestFacility/emplace-0c81.adoc[_» more&period;&period;&period;_]#


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