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

Create an uninitialized datum int‐map and load a reference into `result`.

== Synopsis

Declared in `<bdld_datum.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
void
createUninitializedIntMap(
    xref:BloombergLP/bdld/DatumMutableIntMapRef.adoc[DatumMutableIntMapRef]* 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 int‐map having the specified `capacity`, using the specified `allocator` to supply memory. The behavior is undefined if `capacity` `DatumIntMapEntry` objects would exceed the addressable memory for the platform. Note that the caller is responsible for filling in elements into the datum int‐map and setting its size accordingly. The number of elements in the datum int‐map cannot exceed `capacity`. Also note that any elements in the datum int‐map that need dynamic memory, should also be allocated with `allocator`.

== Parameters

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


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