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.

[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 moststd::numeric_limits<difference_type>::max(). At runtime, the size of the container may be limited to a value smaller thanmax_size() by the amount of RAM available.

[edit]Example

#include <iostream>#include <locale>#include <map> int main(){std::multimap<char,char> p;std::multimap<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';}

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

See also

• In other languages

• Deutsch
• Español
• Français
• Italiano
• 日本語
• Português
• Русский
• 中文