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

Mechanism to build a `Datum` object having an int‐map value.

== Synopsis

Declared in `<bdld_datumintmapbuilder.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
class DatumIntMapBuilder;
----

== Description

This `class` provides a mechanism to build a `Datum` object having an int‐map value in an exception‐safe manner. See `bdld_datum` for more information about integer maps.

== Type Aliases

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdld/DatumIntMapBuilder/SizeType.adoc[`SizeType`] 
| `SizeType` is an alias for a unsigned integral value, representing the capacity or size of a datum int‐map.
| xref:BloombergLP/bdld/DatumIntMapBuilder/allocator_type.adoc[`allocator_type`] 
| Allocator type used by this builder.
|===


== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdld/DatumIntMapBuilder/2constructor-0f.adoc[`DatumIntMapBuilder`]         [.small]#[constructor]#
| Constructors
| xref:BloombergLP/bdld/DatumIntMapBuilder/2destructor.adoc[`~DatumIntMapBuilder`] [.small]#[destructor]#
| Destroy this object.
| xref:BloombergLP/bdld/DatumIntMapBuilder/append.adoc[`append`] 
| Append the specified array `entries` having the specified `size` to the `Datum` int‐map being build by this object.
| xref:BloombergLP/bdld/DatumIntMapBuilder/capacity.adoc[`capacity`] 
| Return the capacity of the held `Datum` int‐map.
| xref:BloombergLP/bdld/DatumIntMapBuilder/commit.adoc[`commit`] 
| Return a `Datum` int‐map value holding the elements supplied to `pushBack` or `append`.
| xref:BloombergLP/bdld/DatumIntMapBuilder/get_allocator.adoc[`get_allocator`] 
| Return the allocator used by this object to supply memory.
| xref:BloombergLP/bdld/DatumIntMapBuilder/pushBack.adoc[`pushBack`] 
| Append the entry with the specified `key` and the specified `value` to the `Datum` int‐map being build by this object.
| xref:BloombergLP/bdld/DatumIntMapBuilder/setSorted.adoc[`setSorted`] 
| Mark the Datum int‐map being built by this object as sorted if the specified `value` is `true` and mark it unsorted otherwise.
| xref:BloombergLP/bdld/DatumIntMapBuilder/size.adoc[`size`] 
| Return the size of the held `Datum` int‐map. The behavior is undefined if `commit` or `sortAndCommit` has already been called on this object.
| xref:BloombergLP/bdld/DatumIntMapBuilder/sortAndCommit.adoc[`sortAndCommit`] 
| Return a `Datum` int‐map value holding the elements supplied to `pushBack` or `append` sorted by their keys.
| xref:BloombergLP/bdld/DatumIntMapBuilder/2conversion.adoc[`operator BloombergLP::bslmf::NestedTraitDeclaration<DatumIntMapBuilder, UsesBslmaAllocator>`] 
| Declare that this type uses a `bslma` allocator.
|===



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