[#BloombergLP-bslstl-SimplePool-reserve]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslstl.adoc[bslstl]::xref:BloombergLP/bslstl/SimplePool.adoc[SimplePool]::reserve
:relfileprefix: ../../../
:mrdocs:

Reserve memory for at least the specified `numBlocks`.

== Synopsis

Declared in `<bslstl_simplepool.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
reserve(xref:BloombergLP/bslstl/SimplePool/size_type.adoc[size_type] numBlocks);
----

== Description

Dynamically allocate a new chunk containing the specified `numBlocks` number of blocks, and add the chunk to the free memory list of this pool. The additional memory is added irrespective of the amount of free memory when called. The behavior is undefined unless `0 < numBlocks`.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *numBlocks*
| number of blocks to allocate and add to the free list
|===


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