[#BloombergLP-bslalg-ArrayPrimitives-uninitializedFillN-06]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslalg.adoc[bslalg]::xref:BloombergLP/bslalg/ArrayPrimitives.adoc[ArrayPrimitives]::uninitializedFillN
:relfileprefix: ../../../
:mrdocs:

Construct copies of the specified `value` of the parameterized type `TARGET_TYPE` into the uninitialized array containing the specified `numElements` starting at the specified `begin` address. If the (template parameter) `ALLOCATOR` type is derived from `bslma::Allocator` and `TARGET_TYPE` supports `bslma` allocators, then the specified `allocator` is passed to each invocation of the `TARGET_TYPE` copy constructor. The behavior is undefined unless the output array contains at least `numElements` uninitialized elements after `begin`. If a `TARGET_TYPE` constructor throws an exception during the operation, then the destructor is called on any newly‐constructed elements, leaving the output array in an uninitialized state. Note that the argument order was chosen to maintain compatibility with the existing `bslalg`.

== Synopsis

Declared in `<bslalg_arrayprimitives.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class TARGET_TYPE>
static
void
uninitializedFillN(
    TARGET_TYPE* begin,
    xref:BloombergLP/bslalg/ArrayPrimitives/size_type.adoc[size_type] numElements,
    TARGET_TYPE const& value,
    xref:BloombergLP/bslma/Allocator.adoc[bslma::Allocator]* allocator);
----


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