[#BloombergLP-bslstl-HashTable-06-setMaxLoadFactor]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslstl.adoc[bslstl]::xref:BloombergLP/bslstl/HashTable-06.adoc[HashTable]::setMaxLoadFactor
:relfileprefix: ../../../
:mrdocs:

Set the maximum load factor permitted by this hash table to the specified `newMaxLoadFactor`, where load factor is the statistical mean number of elements per bucket. If 'newMaxLoadFactor < loadFactor', allocate at least enough buckets to re‐establish the invariant `loadFactor <= maxLoadFactor`. 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. The behavior is undefined unless `0 < maxLoadFactor`.

== Synopsis

Declared in `<bslstl_hashtable.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
setMaxLoadFactor(float newMaxLoadFactor);
----


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