public member function

<unordered_map>

std::unordered_map::max_size

size_type max_size() const noexcept;

Return maximum size

Returns the maximum number of elements that the unordered_map container can hold.

This is the maximum potential number of elements the container can hold due to system constraints or limitations on its library implementation.


Parameters

none

Return Value

The maximum number of elements the object can hold as content.

Member type

size_type is an unsigned integral type.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// unordered_map limits
#include <iostream>
#include <unordered_map>

int main ()
{
  std::unordered_map<int,int> mymap;

  std::cout << "max_size = " << mymap.max_size() << std::endl;
  std::cout << "max_bucket_count = " << mymap.max_bucket_count() << std::endl;
  std::cout << "max_load_factor = " << mymap.max_load_factor() << std::endl;

  return 0;
}

Possible output:
max_size = 357913941
max_bucket_count = 357913941
max_load_factor = 1


Complexity

Constant.

Iterator validity

No changes.

See also

unordered_map::empty
Test whether container is empty (public member function)
unordered_map::max_bucket_count
Return maximum number of buckets (public member function)
unordered_map::max_load_factor
Get or set maximum load factor (public member function)