[#BloombergLP-bdlc-CompactedArray-reserveCapacity-0b]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlc.adoc[bdlc]::xref:BloombergLP/bdlc/CompactedArray.adoc[CompactedArray]::reserveCapacity
:relfileprefix: ../../../
:mrdocs:

Make the capacity of this array at least the specified `numElements`.

== Synopsis

Declared in `<bdlc_compactedarray.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
reserveCapacity(std::size_t numElements);
----

== Description

Make the capacity of this array at least the specified `numElements`, assuming the number of unique elements within this array does not increase. This method has no effect if the current capacity meets or exceeds the required capacity. The behavior is undefined unless `false == isEmpty() || 0 == numElements`. Note that the assumption of not increasing the number of unique elements implies the need for the narrow contract.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *numElements*
| minimum element capacity to reserve
|===


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