diff --git a/doc/unordered/unordered_multimap.adoc b/doc/unordered/unordered_multimap.adoc index 08189570..f14f6a61 100644 --- a/doc/unordered/unordered_multimap.adoc +++ b/doc/unordered/unordered_multimap.adoc @@ -1345,7 +1345,9 @@ Effects:;; Changes the container's maximum load factor, using `z` as a hint. void rehash(size_type n); ``` -Changes the number of buckets so that there at least `n` buckets, and so that the load factor is less than the maximum load factor. +Changes the number of buckets so that there are at least `n` buckets, and so that the load factor is less than or equal to the maximum load factor. When applicable, this will either grow or shrink the `bucket_count()` associated with the container. + +When `size() == 0`, `rehash(0)` will deallocate the underlying buckets array. Invalidates iterators, and changes the order of elements. Pointers and references to elements are not invalidated. @@ -1359,6 +1361,10 @@ Throws:;; The function has no effect if an exception is thrown, unless it is thr void reserve(size_type n); ``` +Equivalent to `a.rehash(ceil(n / a.max_load_factor()))`, or `a.rehash(1)` if `n > 0` and `a.max_load_factor() == std::numeric_limits::infinity()`. + +Similar to `rehash`, this function can be used to grow or shrink the number of buckets in the container. + Invalidates iterators, and changes the order of elements. Pointers and references to elements are not invalidated. [horizontal]