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

Reserve capacity for at least `numBlocks` blocks of the specified `size`.

== Synopsis

Declared in `<bdlma_multipool.h>`

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

== Description

Reserve memory from this multipool to satisfy memory requests for at least the specified `numBlocks` having the specified `size` (in bytes) before the pool replenishes. If `size` is 0, this method has no effect. The behavior is undefined unless `size <= maxPooledBlockSize()` and `0 <= numBlocks`.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *size*
| size in bytes of each block to reserve
| *numBlocks*
| minimum number of blocks to reserve
|===


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