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

This `class` provides a mechanism to build a `Datum` object having a map value in an exception&hyphen;safe manner&period;

== Synopsis

Declared in `&lt;bdld&lowbar;datummapbuilder&period;h&gt;`

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

== Type Aliases

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


== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdld/DatumMapBuilder/2constructor-0c.adoc[`DatumMapBuilder`]         [.small]#[constructor]#
| Constructors
| xref:BloombergLP/bdld/DatumMapBuilder/2destructor.adoc[`&#126;DatumMapBuilder`] [.small]#[destructor]#
| Destroy this object&period; If this object is holding a datum map that has not been adopted, then the datum map is disposed after destroying each of its elements&period;
| xref:BloombergLP/bdld/DatumMapBuilder/append.adoc[`append`] 
| Append the specified map entries to this builder&period;
| xref:BloombergLP/bdld/DatumMapBuilder/capacity.adoc[`capacity`] 
| Return the capacity of the held `Datum` map&period;
| xref:BloombergLP/bdld/DatumMapBuilder/commit.adoc[`commit`] 
| Return a `Datum` map of the elements supplied so far&period;
| xref:BloombergLP/bdld/DatumMapBuilder/get_allocator.adoc[`get&lowbar;allocator`] 
| Return the allocator used by this object to supply memory&period;
| xref:BloombergLP/bdld/DatumMapBuilder/pushBack.adoc[`pushBack`] 
| Append an entry with the specified `key` and `value`&period;
| xref:BloombergLP/bdld/DatumMapBuilder/setSorted.adoc[`setSorted`] 
| Mark the map being built as sorted or unsorted&period;
| xref:BloombergLP/bdld/DatumMapBuilder/size.adoc[`size`] 
| Return the size of the held `Datum` map&period; The behavior is undefined if `commit` or `sortAndCommit` has already been called on this object&period;
| xref:BloombergLP/bdld/DatumMapBuilder/sortAndCommit.adoc[`sortAndCommit`] 
| Return a sorted `Datum` map of the elements supplied so far&period;
| xref:BloombergLP/bdld/DatumMapBuilder/2conversion.adoc[`operator BloombergLP::bslmf::NestedTraitDeclaration&lt;DatumMapBuilder, UsesBslmaAllocator&gt;`] 
| `DatumMapBuilder` is allocator&hyphen;aware&period;
|===



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