std::unordered_set<Key,Hash,KeyEqual,Allocator>:: max_size

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

戻り値

要素の最大数。

計算量

定数。

注記

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

例

#include <iostream>
#include <locale>
#include <unordered_set>
int main()
{
    std::unordered_set<char> p;
    std::unordered_set<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

関連項目