[#BloombergLP-bdld-Datum-createUninitializedMap-0ec]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdld.adoc[bdld]::xref:BloombergLP/bdld/Datum.adoc[Datum]::createUninitializedMap
:relfileprefix: ../../../
:mrdocs:

`createUninitializedMap` overloads

== Synopses

Declared in `<bdld_datum.h>`

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


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

[.small]#xref:BloombergLP/bdld/Datum/createUninitializedMap-05.adoc[_» more..._]#

Load the specified `result` with a reference to a newly created datum‐key‐owning map having the specified `capacity` and `keysCapacity`, using the specified `allocator` to supply memory. The behavior is undefined if `capacity` `DatumMapEntry` object plus `keysCapacity` would exceed the addressable memory for the platform. Note that the caller is responsible for filling in elements into the datum‐key‐owning map, copying the keys into it, and setting its size accordingly. The number of elements in the datum‐key‐owning map cannot exceed `capacity` and total size of all the keys cannot exceed `keysCapacity`. Also note that any elements in the datum‐key‐owning map that need dynamic memory, should also be allocated with `allocator`.


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

[.small]#xref:BloombergLP/bdld/Datum/createUninitializedMap-0e8.adoc[_» more..._]#


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