public member function
<map>

std::map::max_size

size_type max_size() const;
size_type max_size() const noexcept;
返回最大尺寸
返回 map 容器可以容纳的元素的最大数量。

这是容器可能达到的最大潜在 size,因为存在已知的系统或库实现限制,但容器并不能保证一定能达到该大小:在达到该大小之前的任何时候,它都可能因无法分配存储而失败。

参数



返回值

map 容器可以容纳的最大元素数量。

成员类型size_type是一种无符号整型类型。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
// 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用于提前检查 map 是否允许插入 1000 个元素。

复杂度

常量。

迭代器有效性

没有变化。

数据竞争

访问容器。
不访问任何元素:并发访问或修改它们是安全的。

异常安全

无异常保证:此成员函数从不抛出异常。

另见