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

This `class` provides a mechanism to build a `Datum` object having an array value in an exception‐safe manner.

== Synopsis

Declared in `<bdld_datumarraybuilder.h>`

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

== Type Aliases

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdld/DatumArrayBuilder/SizeType.adoc[`SizeType`] 
| `SizeType` is an alias for an unsigned integral value, representing the capacity or length of a datum array.
| xref:BloombergLP/bdld/DatumArrayBuilder/allocator_type.adoc[`allocator_type`] 
| Alias for the allocator type used by this builder.
|===


== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdld/DatumArrayBuilder/2constructor-02.adoc[`DatumArrayBuilder`]         [.small]#[constructor]#
| Constructors
| xref:BloombergLP/bdld/DatumArrayBuilder/2destructor.adoc[`~DatumArrayBuilder`] [.small]#[destructor]#
| Destroy this object. If this object is holding a `Datum` array that has not been adopted, then the `Datum` array is disposed after destroying each of its elements.
| xref:BloombergLP/bdld/DatumArrayBuilder/append.adoc[`append`] 
| Append the specified array `values` having the specified `length` to the `Datum` array being built by this object.
| xref:BloombergLP/bdld/DatumArrayBuilder/capacity.adoc[`capacity`] 
| Return the capacity of the held `Datum` array.
| xref:BloombergLP/bdld/DatumArrayBuilder/commit.adoc[`commit`] 
| Return a `Datum` array value holding the elements supplied to `pushBack` or `append`.
| xref:BloombergLP/bdld/DatumArrayBuilder/get_allocator.adoc[`get_allocator`] 
| Return the allocator used by this object to supply memory.
| xref:BloombergLP/bdld/DatumArrayBuilder/pushBack.adoc[`pushBack`] 
| Append the specified `value` to the `Datum` array being built by this object.
| xref:BloombergLP/bdld/DatumArrayBuilder/size.adoc[`size`] 
| Return the size of the held `Datum` array. The behavior is undefined if `commit` has already been called on this object.
| xref:BloombergLP/bdld/DatumArrayBuilder/2conversion.adoc[`operator BloombergLP::bslmf::NestedTraitDeclaration<DatumArrayBuilder, UsesBslmaAllocator>`] 
| Declare that this type uses a `bslma` allocator.
|===



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