std::forward_list<T,Allocator>:: max_size

コンテナがシステムまたはライブラリ実装の制限により保持できる最大要素数を返します。つまり、 std:: distance ( begin ( ) , end ( ) ) が最大のコンテナに対して返す値です。

戻り値

要素の最大数。

計算量

定数。

注記

この値は通常、コンテナのサイズに関する理論上の上限を反映しており、最大で std:: numeric_limits < difference_type > :: max ( ) となります。実行時には、利用可能なRAMの量によって、コンテナのサイズは max_size() よりも小さい値に制限される場合があります。

例

#include <iostream>
#include <locale>
#include <forward_list>
int main()
{
    std::forward_list<char> p;
    std::forward_list<long> 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() = 1,152,921,504,606,846,975 = 0xFFF,FFF,FFF,FFF,FFF
q.max_size() = 1,152,921,504,606,846,975 = 0xFFF,FFF,FFF,FFF,FFF