C++ Reference: Standard C++ Library reference: Containers: map: map: max_size

C++官网参考链接：https://cplusplus.com/reference/map/map/max_size/

公有成员函数
<map>
std::map::max_size
C++98
size_type max_size() const;
C++11
size_type max_size() const noexcept;
返回最大大小
返回map容器所能容纳的元素的最大数量。
由于已知的系统或库实现限制，这是容器可能达到的最大潜在的size，但不能保证容器能够达到该大小：在达到该大小之前，它仍然可能在任何点无法分配存储空间。

形参 
没有形参。 

返回值
map容器可以容纳作为内容的元素的最大数量。
成员类型size_type是无符号整型。

用例
// map::max_size
#include <iostream>
#include <map>

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

  if (mymap.max_size()>1000)
  {
    for (i=0; i<1000; i++) mymap[i]=0;
    std::cout << "The map contains 1000 elements.\n";
  }
  else std::cout << "The map could not hold 1000 elements.\n";

  return 0;
}
在这里，成员max_size用于预先检查映射是否允许插入1000个元素。

复杂度
常量。

iterator的有效性
没有变化。

数据竞争
访问容器。
不访问任何元素：同时访问或修改它们是安全的。

异常安全
无抛出保证：该成员函数从不抛出异常。