CAtlMap::InitHashTable
更新 : 2007 年 11 月
ハッシュ テーブルを初期化します。
bool InitHashTable(
UINT nBins,
bool bAllocNow = true
);
パラメータ
nBins
ハッシュ テーブルが使用するビン数。詳細については、CAtlMap::CAtlMap の説明を参照してください。bAllocNow
メモリをいつ割り当てるかを示すフラグ。
戻り値
初期化が正常に終了した場合は true を返します。それ以外の場合は、false を返します。
解説
InitHashTable は、ハッシュ テーブルに要素を格納する前に呼び出す必要があります。このメソッドを明示的に呼び出さなかった場合、要素が初めて追加されたときに、CAtlMap コンストラクタによって指定されたビン数を使用して自動的に呼び出されます。明示的に呼び出した場合、nBins パラメータで指定された新しいビン数を使ってマップが初期化されます。
パラメータ bAllocNow を false にすると、最初の要求があるまで、ハッシュ テーブルに必要なメモリが割り当てられることはありません。これは、マップが使用されるかどうかが不明である場合に便利です。
使用例
「CAtlMap::CAtlMap」の例を参照してください。
必要条件
ヘッダー : atlcoll.h