[#BloombergLP-bdld-Datum-createUninitializedArray]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdld.adoc[bdld]::xref:BloombergLP/bdld/Datum.adoc[Datum]::createUninitializedArray
:relfileprefix: ../../../
:mrdocs:

Create an uninitialized datum array and load a reference into `result`.

== Synopsis

Declared in `<bdld_datum.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
void
createUninitializedArray(
    xref:BloombergLP/bdld/DatumMutableArrayRef.adoc[DatumMutableArrayRef]* result,
    xref:BloombergLP/bdld/Datum/SizeType.adoc[SizeType] capacity,
    xref:BloombergLP/bdld/Datum/AllocatorType.adoc[AllocatorType] const& allocator);
----

== Description

Load the specified `result` with a reference to a newly created datum array having the specified `capacity`, using the specified `allocator` to supply memory. The behavior is undefined if `capacity` `Datum` objects would exceed the addressable memory for the platform. Note that the caller is responsible for filling in elements into the datum array and setting its length accordingly. The number of elements in the datum array cannot exceed `capacity`. Also note that any elements in the datum array that need dynamic memory must be allocated with `allocator`.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *result*
| receives the mutable array reference
| *capacity*
| maximum number of elements the array can hold
| *allocator*
| memory allocator to use
|===


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