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

Synopsis

Declared in <bdld_datum.h>

static
void
createUninitializedArray(
    DatumMutableArrayRef* result,
    SizeType capacity,
    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

Name

Description

result

receives the mutable array reference

capacity

maximum number of elements the array can hold

allocator

memory allocator to use

Created with MrDocs