C++ STLのmultimap::max_size()関数の使い方を徹底解説

この記事では、C++ STLにおけるmultimap::max_size()関数の動作、構文、および具体的な使用例について詳しく解説します。

C++ STLにおけるmultimapとは？

multimapは連想コンテナの一種で、mapコンテナとよく似た性質を持っています。キー（key）とマップされた値（mapped value）の組み合わせで構成される要素を、特定の順序で格納することができます。multimapコンテナの最大の特徴は、同じキーに複数の要素を関連付けられる点です。また、内部のデータは常にキーに基づいて自動的にソートされます。

multimap::max_size()とは？

multimap::max_size()関数は、C++ STLに組み込まれている関数で、<map>ヘッダーファイル内で定義されています。max_size()は、multimapコンテナが保持できる最大サイズを返すために使用されます。

この関数は、対象のmultimapコンテナが格納できる要素数の上限を確認するために使われます。ただし、このサイズはあくまでコンテナの「潜在的な容量」を示すものであり、実際にその値まで到達できるかどうかは保証されていません。

構文

multiMap_name.max_size();

パラメータ

この関数はパラメータを受け取りません。

戻り値

この関数は、コンテナが保持できる要素の最大数を返します。

入力例

multimap newmap;
newmap.max_size();

出力例

Max size of multimap is − 461168601842738790

サンプルコード

#include <bits/stdc++.h>
using namespace std;
int main(){
    //multimapの作成
    multimap<int, int> mul;
    multimap<char,char> char_mul;
    multimap<float, float> float_mul;
    cout<<"Max size of multimap is "<<mul.max_size();
    cout<<"\nMax size of multimap is "<<char_mul.max_size();
    cout<<"\nMax size of multimap is "<<float_mul.max_size();
    return 0;
}

出力

上記のコードを実行すると、以下のような出力が生成されます。

Max size of multimap is 461168601842738790
Max size of multimap is 461168601842738790
Max size of multimap is 461168601842738790

なお、max_size()の戻り値は実行環境、コンパイラ、システムのメモリ構成によって異なる場合があります。そのため、実際に表示される数値は上記の例と必ずしも一致しない点に注意してください。