Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/container/map/max size"

From cppreference.com
< cpp‎ | container‎ | map
m (Shorten template names. Use {{lc}} where appropriate.)
m (langlinks)
 
Line 1: Line 1:
 
{{include page|cpp/container/max_size|map}}
 
{{include page|cpp/container/max_size|map}}
  
[[de:cpp/container/map/max size]]
+
{{langlinks|de|es|fr|it|ja|pt|ru|zh}}
[[es:cpp/container/map/max size]]
+
[[fr:cpp/container/map/max size]]
+
[[it:cpp/container/map/max size]]
+
[[ja:cpp/container/map/max size]]
+
[[pt:cpp/container/map/max size]]
+
[[ru:cpp/container/map/max size]]
+
[[zh:cpp/container/map/max size]]
+

Latest revision as of 18:49, 29 November 2021

 
 
 
 
size_type max_size() const;
(noexcept since C++11)

Returns the maximum number of elements the container is able to hold due to system or library implementation limitations, i.e. std::distance(begin(), end()) for the largest container.

Contents

[edit] Parameters

(none)

[edit] Return value

Maximum number of elements.

[edit] Complexity

Constant.

[edit] Notes

This value typically reflects the theoretical limit on the size of the container, at most std::numeric_limits<difference_type>::max(). At runtime, the size of the container may be limited to a value smaller than max_size() by the amount of RAM available.

[edit] Example

#include <iostream>
#include <locale>
#include <map>
 
int main()
{
    std::map<char, char> p;
    std::map<long, char> q;
 
    std::cout.imbue(std::locale("en_US.UTF-8"));
    std::cout << std::uppercase
              << "p.max_size() = " << std::dec << p.max_size() << " = 0x"
              << std::hex << p.max_size() << '\n'
              << "q.max_size() = " << std::dec << q.max_size() << " = 0x"
              << std::hex << q.max_size() << '\n';
}

Possible output:

p.max_size() = 461,168,601,842,738,790 = 0x666,666,666,666,666
q.max_size() = 384,307,168,202,282,325 = 0x555,555,555,555,555

See also

returns the number of elements
(public member function) [edit]