hash_multimap::get_allocator

[!メモ]

この API は、互換性のために残されています。代わりに unordered_multimap クラスです。

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

Allocator get_allocator( ) const;

戻り値

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

解説

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

Visual C++ .NET 2003では、<hash_map> と <hash_set> ヘッダー ファイルのメンバーはstdの名前空間に存在しなくなりましたが、ではなくstdextの名前空間に型。詳細については、「The stdext Namespace」を参照してください。

使用例

// hash_multimap_get_allocator.cpp
// compile with: /EHsc
#include <hash_map>
#include <iostream>

int main( )
{
   using namespace std;
   using namespace stdext;
   hash_multimap <int, int>::allocator_type hm1_Alloc;
   hash_multimap <int, int>::allocator_type hm2_Alloc;
   hash_multimap <int, double>::allocator_type hm3_Alloc;
   hash_multimap <int, int>::allocator_type hm4_Alloc;

   // The following lines declare objects
   // that use the default allocator.
   hash_multimap <int, int> hm1;
   hash_multimap <int, int> hm2;
   hash_multimap <int, double> hm3;

   hm1_Alloc = hm1.get_allocator( );
   hm2_Alloc = hm2.get_allocator( );
   hm3_Alloc = hm3.get_allocator( );

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

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

   // The following line creates a hash_multimap hm4
   // with the allocator of hash_multimap hm1.
   hash_multimap <int, int> hm4( less<int>( ), hm1_Alloc );

   hm4_Alloc = hm4.get_allocator( );

   // Two allocators are interchangeable if
   // storage allocated from each can be
   // deallocated by the other
   if( hm1_Alloc == hm4_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.

必要条件

ヘッダー: <hash_map>

名前空間: のstdext

参照

関連項目

hash_multimap Class

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