[#BloombergLP-bslstl-HashTable-09-reserveForNumElements]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslstl.adoc[bslstl]::xref:BloombergLP/bslstl/HashTable-09.adoc[HashTable<UnorderedMapKeyConfiguration<basic_string<char> const, pair<basic_string<char> const, Json>>, TransparentHash, TransparentEqualTo, allocator<pair<basic_string<char> const, Json>>>]::reserveForNumElements
:relfileprefix: ../../../
:mrdocs:

Re‐organize this hash‐table to have a sufficient number of buckets to accommodate at least the specified `numElements` without exceeding the `maxLoadFactor`, and ensure that there are sufficient nodes pre‐allocated in this object's node pool. If this function tries to allocate a number of buckets larger than can be represented by this hash table's `SizeType`, a `std::length_error` exception is thrown. This operation provides the strong exception guarantee (see {`bsldoc_glossary`}) unless the `hasher` throws, in which case this operation provides the basic exception guarantee, leaving the hash‐table in a valid, but otherwise unspecified (and potentially empty), state.

== Synopsis

Declared in `<bslstl_hashtable.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
reserveForNumElements(xref:BloombergLP/bslstl/HashTable-09/SizeType.adoc[SizeType] numElements);
----


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