# std::multiset<Key,Compare,Allocator>::max_size

< cpp‎ | container‎ | multiset

size_type max_size() const; |  | (C++11 前)
size_type max_size() const noexcept; |  | (C++11 起)

返回根据系统或库实现限制的容器可保有的元素最大数量，即对于最大容器的 std::distance(begin(), end()) 。

### 参数

（无）

### 返回值

元素数量的最大值。

### 复杂度

常数。

### 注解

此值通常反映容器大小上的理论极限，至多为 std::numeric_limits<difference_type>::max() 。运行时，可用 RAM 总量可能会限制容器大小到小于 `max_size()` 的值。

### 示例

    #include <iostream>
    #include <set>

    int main()
    {
        std::multiset<char> s;
        std::cout << "Maximum size of a 'multiset' is " << s.max_size() << "\n";
    }

可能的输出：

    Maximum size of a 'multiset' is 576460752303423487

### 参阅

size | 返回容纳的元素数 (公开成员函数)