[#BloombergLP-bdlma-SequentialAllocator-reserveCapacity]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlma.adoc[bdlma]::xref:BloombergLP/bdlma/SequentialAllocator.adoc[SequentialAllocator]::reserveCapacity
:relfileprefix: ../../../
:mrdocs:

Reserve enough memory to satisfy at least `numBytes` of allocations without replenishment&period;

== Synopsis

Declared in `&lt;bdlma&lowbar;sequentialallocator&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
reserveCapacity(xref:BloombergLP/bsls/Types/size_type.adoc[bsls::Types::size&lowbar;type] numBytes);
----

== Description

Reserve sufficient memory to satisfy allocation requests for at least the specified `numBytes` without replenishment (i&period;e&period;, without dynamic allocation)&period; If `numBytes` is 0, no memory is reserved&period; Note that, when the `numBytes` is distributed over multiple `allocate` requests &hyphen; due to alignment effects &hyphen; it is possible that not all `numBytes` of memory will be used for allocation before triggering dynamic allocation&period;

== Parameters

[cols="1,4"]
|===
| Name| Description
| *numBytes*
| minimum number of bytes to reserve
|===


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