multimap::get_allocator

map の構築に使用されるアロケーター オブジェクトのコピーを返します。

allocator_type get_allocator( ) const;

戻り値

map で使用されるアロケーター。

解説

map のクラスのアロケーターは、クラスがストレージを管理する方法を指定します。STL コンテナー クラスで提供される既定のアロケーターは、大部分のプログラミングのニーズに十分です。独自のアロケーター クラスを作成し、使用すると、高度な C++ のトピックです。

使用例

// multimap_get_allocator.cpp
// compile with: /EHsc
#include <map>
#include <iostream>

int main( )
{
   using namespace std;
   multimap <int, int>::allocator_type m1_Alloc;
   multimap <int, int>::allocator_type m2_Alloc;
   multimap <int, double>::allocator_type m3_Alloc;
   multimap <int, int>::allocator_type m4_Alloc;

   // The following lines declare objects
   // that use the default allocator.
   multimap <int, int> m1;
   multimap <int, int, allocator<int> > m2;
   multimap <int, double, allocator<double> > m3;

   m1_Alloc = m1.get_allocator( );
   m2_Alloc = m2.get_allocator( );
   m3_Alloc = m3.get_allocator( );

   cout << "The number of integers that can be allocated"
        << endl << "before free memory is exhausted: "
        << m2.max_size( ) << ".\n" << endl;

   cout << "The number of doubles that can be allocated"
        << endl << "before free memory is exhausted: "
        << m3.max_size( ) <<  ".\n" << endl;

   // The following line creates a multimap m4
   // with the allocator of multimap m1.
   map <int, int> m4( less<int>( ), m1_Alloc );

   m4_Alloc = m4.get_allocator( );

   // Two allocators are interchangeable if
   // storage allocated from each can be
   // deallocated via the other
   if( m1_Alloc == m4_Alloc )
   {
      cout << "The allocators are interchangeable."
           << endl;
   }
   else   
   {
      cout << "The allocators are not interchangeable."
           << endl;
   }
}

出力例

次の出力は、x86 の場合です。

The number of integers that can be allocated
before free memory is exhausted: 536870911.

The number of doubles that can be allocated
before free memory is exhausted: 268435455.

The allocators are interchangeable.

必要条件

ヘッダー: <map>

名前空間: std

参照

関連項目

multimap Class

標準テンプレート ライブラリ