[#BloombergLP-bslalg-ArrayPrimitives-defaultConstruct-07]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslalg.adoc[bslalg]::xref:BloombergLP/bslalg/ArrayPrimitives.adoc[ArrayPrimitives]::defaultConstruct
:relfileprefix: ../../../
:mrdocs:

Value‐initialize elements into an uninitialized array.

== Synopsis

Declared in `<bslalg_arrayprimitives.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class ALLOCATOR>
static
void
defaultConstruct(
    bsl::allocator_traits<ALLOCATOR>::pointer begin,
    xref:BloombergLP/bslalg/ArrayPrimitives/size_type.adoc[size_type] numElements,
    ALLOCATOR allocator);
----

== Description

Value‐initialize the specified `numElements` objects of type `allocator_traits<ALLOCATOR>::value_type` into the uninitialized array beginning at the specified `begin` location, using the specified `allocator` to supply memory (if required). If a constructor throws an exception during this operation, then the destructor is called on any newly constructed elements, leaving the output array in an uninitialized state. The behavior is undefined unless the `begin` refers to space sufficient to hold `numElements`.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *begin*
| beginning of the uninitialized destination range
| *numElements*
| number of elements to value‐initialize
| *allocator*
| allocator used to supply memory if required
|===


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