クラスHashMap<K,V>

java.lang.Object

java.util.AbstractMap<K,V>

java.util.HashMap<K,V>

型パラメータ:

K - このマップによって保持されるキーのタイプ

V - マップされた値のタイプ

すべての実装されたインタフェース:

Serializable, Cloneable, Map<K,V>

直系の既知のサブクラス:

LinkedHashMap, PrinterStateReasons

public class HashMap<K,V> extends AbstractMap<K,V> implements Map<K,V>, Cloneable, Serializable

Mapインタフェースのハッシュ表ベースの実装。 この実装では、すべてのオプションのマップ操作が提供され、null値およびnullキーが許可されます。 (HashMapクラスは、Hashtableとほぼ同等ですが、非同期でNULLが許可される点が異なります。) このクラスはマップの順序を保証しません。特に、その順序を常に一定に保つことを保証しません。

この実装は、ハッシュ関数が要素をバケット間で適切に分散すると仮定して、基本操作(getおよびput)に対して一定時間のパフォーマンスを提供します。 コレクション・ビューを反復するには、HashMapインスタンス(バケット数)の"容量"とそのサイズ(キーと値のマッピングの数)に比例した時間が必要です。 したがって、反復処理の性能が重要な場合は、初期容量をあまり高く(負荷係数をあまり低く)設定しないことが非常に重要です。

HashMapのインスタンスには、そのパフォーマンスに影響する2つのパラメータがあります: 初期容量および負荷率。 容量はハッシュ表のバケット数であり、初期容量は単純にハッシュ表が作成された時点での容量です。 負荷係数は、ハッシュ表がどの程度いっぱいになると、その容量が自動的に増加されるかの基準です。 ハッシュ表エントリ数が負荷係数と現在の容量の積を超えると、ハッシュ表のハッシュがやり直され (つまり、内部データ構造が再構築され)、ハッシュ表のバケット数は約2倍になります。

ほとんどの場合、デフォルトの負荷係数(.75)では、時間コストとスペース・コストの釣合いを取ります。 値を大きくすると領域のオーバーヘッドは減少しますが、ルックアップ・コストは(getやputなど、HashMapクラスのほとんどの操作に反映されます)になります。 初期容量を設定するときは、rehashオペレーションの回数を最小限に抑えるために、マップのエントリ予定数および負荷係数を考慮する必要があります。 初期容量が、エントリの最大数を負荷係数で割った値より大きい場合、rehashオペレーションは起こりません。

多数のマッピングをHashMapインスタンスに格納する場合、十分な容量でそれを作成すると、表の拡張に必要な自動リハッシングを実行するよりも、マッピングをより効率的に格納できます。 同じhashCode()で多数のキーを使用すると、必ずいずれかのハッシュ表のパフォーマンスが低下することに注意してください。 影響を軽減するため、キーがComparableである場合は、このクラスでキー間の比較順序を使用してキーの重複を解消できます。

この実装はsynchronizedされません。 複数のスレッドが並行してハッシュ・マップにアクセスし、それらのスレッドの少なくとも1つが構造的にマップを変更する場合は、外部でその同期をとる必要があります。 構造的な変更とは、1つ以上のマッピングを追加または削除するオペレーションのことです。すでにインスタンスに格納されているキーに関連付けられた値を変更することは構造的な変更ではありません。 これは通常、マップを自然にカプセル化する一部のオブジェクトでsynchronizedすることによって達成されます。 そのようなオブジェクトが存在しない場合は、Collections.synchronizedMapメソッドを使用してマップを「ラップ」することをお薦めします。 マップが誤ってsynchronizedなしでアクセスされるのを防ぐために、作成時に行うことをお薦めします。

  Map m = Collections.synchronizedMap(new HashMap(...));

このクラスの"コレクション表示メソッド"すべてによって返されるイテレータは、fail-fastです: イテレータの作成後にマップが構造的に変更された場合、イテレータ独自のremoveメソッド以外のすべての方法で、イテレータはConcurrentModificationExceptionをスローします。 このように、並行して変更が行われると、イテレータは、将来の予測できない時点において予測できない動作が発生する危険を回避するために、ただちにかつ手際よく例外をスローします。

通常、非同期の並行変更がある場合、確かな保証を行うことは不可能なので、イテレータのフェイルファストの動作を保証することはできません。 フェイルファスト・イテレータは、ベスト・エフォート・ベースでConcurrentModificationExceptionをスローします。 したがって、正確を期すためにこの例外に依存するプログラムを書くことは誤りです。イテレータのフェイルファストの動作はバグを検出するためにのみ使用すべきです。

このクラスは、Java Collections Frameworkのメンバーです。

導入されたバージョン:

1.2

関連項目:

• Object.hashCode()
• Collection
• Map
• TreeMap
• Hashtable
• 直列化された形式

ネストされたクラスのサマリー

クラスAbstractMapで宣言されたネストされたクラス/インタフェース

AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>

修飾子と型	クラス	説明
static class	AbstractMap.SimpleEntry<K,V>	キーと値を保持するエントリ。
static class	AbstractMap.SimpleImmutableEntry<K,V>	キーと値を保守する変更不可のエントリ。

インタフェースMapで宣言されたネストされたクラス/インタフェース

Map.Entry<K,V>

修飾子と型	インタフェース	説明
static interface	Map.Entry<K,V>	マップのエントリ(キーと値のペア)です。

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
HashMap()	デフォルトの初期容量(16)およびデフォルトのロード・ファクタ(0.75)を使用して、空のHashMapを作成します。
HashMap(int initialCapacity)	指定された初期容量およびデフォルトのロード・ファクタ(0.75)を使用して、空のHashMapを作成します。
HashMap(int initialCapacity, float loadFactor)	指定された初期容量と負荷係数を持つ空のHashMapを構築します。
HashMap(Map<? extends K, ? extends V> m)	指定されたMapと同じマッピングで新しいHashMapを作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	clear()	すべてのマッピングをマップから削除します。
Object	clone()	このHashMapインスタンスのシャロー・コピーを返します: キーと値自体はクローンされません。
V	compute(K key, BiFunction<? super K, ? super V, ? extends V> remappingFunction)	指定されたキーとその現在のマップされた値のマッピングをコンピュートしようとします。現在のマッピング(オプションの操作)がない場合はnullです。
V	computeIfAbsent(K key, Function<? super K, ? extends V> mappingFunction)	指定されたキーが値(または、nullにマップされます。)にまだ関連付けられていない場合、指定されたマッピング関数を使用してその値をコンピュートし、null (オプションの操作)でないかぎりこのマップに入力します。
V	computeIfPresent(K key, BiFunction<? super K, ? super V, ? extends V> remappingFunction)	指定されたキーの値が存在し、null以外の場合は、キーとその現在のマップされた値(オプションの操作)を指定して、新しいマッピングのコンピュートを試みます。
boolean	containsKey(Object key)	指定されたキーのマッピングがこのマップに含まれている場合にtrueを返します。
boolean	containsValue(Object value)	このマップが1つまたは複数のキーと指定された値をマッピングしている場合にtrueを返します。
Set<Map.Entry<K,V>>	entrySet()	このマップに含まれるマッピングのSetビューを返します。
V	get(Object key)	指定されたキーがマップされている値を返します。そのキーのマッピングがこのマップに含まれていない場合はnullを返します。
boolean	isEmpty()	このマップがキーと値のマッピングを保持しない場合にtrueを返します。
Set<K>	keySet()	このマップに含まれるキーのSetビューを返します。
V	merge(K key, V value, BiFunction<? super V, ? super V, ? extends V> remappingFunction)	指定されたキーがまだ値に関連付けられていない場合、またはnullに関連付けられている場合は、指定されたnull以外の値(オプションの操作)に関連付けます。
static <K,V> HashMap<K,V>	newHashMap(int numMappings)	必要なマッピング数に適した新しい空のHashMapを作成します。
V	put(K key, V value)	指定された値と指定されたキーをこのマップに関連付けます。
void	putAll(Map<? extends K, ? extends V> m)	指定されたマップからすべてのマッピングをマップにコピーします。
V	remove(Object key)	指定されたキーのマッピングがあればマップから削除します。
int	size()	このマップ内のキー値マッピングの数を返します。
Collection<V>	values()	このマップに含まれる値のCollectionビューを返します。

クラスで宣言されたメソッド AbstractMap

equals, hashCode, toString

修飾子と型	メソッド	説明
boolean	equals(Object o)	指定されたオブジェクトがこのマップと等しいかどうかを比較します。
int	hashCode()	マップのハッシュ・コード値を返します。
String	toString()	このマップの文字列表現を返します。

クラスオブジェクトで宣言されたメソッド

finalize, getClass, notify, notifyAll, wait, wait, wait

修飾子と型	メソッド	説明
protected void	finalize()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 最終決定は非推奨であり、将来のリリースで削除される可能性があります。
final Class<?>	getClass()	このObjectの実行時クラスを返します。
final void	notify()	このオブジェクトのモニターで待機中のスレッドを1つ再開します。
final void	notifyAll()	このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
final void	wait()	現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
final void	wait(long timeoutMillis)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
final void	wait(long timeoutMillis, int nanos)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

インタフェースMapで宣言されたメソッド

forEach, getOrDefault, putIfAbsent, remove, replace, replace, replaceAll

修飾子と型	メソッド	説明
default void	forEach(BiConsumer<? super K, ? super V> action)	このマップのすべてのエントリの処理が完了するかアクションから例外がスローされるまで、各エントリに対して指定されたアクションを実行します。
default V	getOrDefault(Object key, V defaultValue)	指定されたキーがマップされている値を返します。このマップにそのキーのマッピングが含まれていない場合はdefaultValueを返します。
default V	putIfAbsent(K key, V value)	指定されたキーが値(または、nullにマップされます。)にまだ関連付けられていない場合、そのキーは指定された値に関連付けられ、nullを返します。それ以外の場合は、現在の値(オプションの操作)を返します。
default boolean	remove(Object key, Object value)	指定されたキーが現在、指定された値(オプションの操作)にマップされている場合にのみ、そのキーのエントリを削除します。
default V	replace(K key, V value)	指定されたキーのエントリが、現在値(オプションの操作)にマップされている場合にのみ、そのエントリを置換します。
default boolean	replace(K key, V oldValue, V newValue)	指定された値(オプションの操作)に現在マップされている場合にのみ、指定されたキーのエントリを置換します。
default void	replaceAll(BiFunction<? super K, ? super V, ? extends V> function)	すべてのエントリが処理されるか、関数が例外(オプションの操作)をスローするまで、各エントリの値を、そのエントリの指定された関数を呼び出した結果に置き換えます。

コンストラクタの詳細

HashMap

public HashMap(int initialCapacity, float loadFactor)

指定された初期容量と負荷係数を持つ空のHashMapを構築します。

APIのノート:

予想される数のマッピングに対応する初期容量を持つHashMapを作成するには、newHashMapを使用します。

パラメータ:

initialCapacity - 初期容量

loadFactor - 負荷係数

スロー:

IllegalArgumentException - 初期容量が負であるか、負荷係数が正でない場合

HashMap

public HashMap(int initialCapacity)

指定された初期容量およびデフォルトのロード・ファクタ(0.75)を使用して、空のHashMapを作成します。

APIのノート:

予想される数のマッピングに対応する初期容量を持つHashMapを作成するには、newHashMapを使用します。

パラメータ:

initialCapacity - 初期容量。

スロー:

IllegalArgumentException - 初期容量が負の場合。

HashMap

public HashMap()

デフォルトの初期容量(16)およびデフォルトのロード・ファクタ(0.75)を使用して、空のHashMapを作成します。

HashMap

public HashMap(Map<? extends K, ? extends V> m)

指定されたMapと同じマッピングで新しいHashMapを作成します。 HashMapは、デフォルトのロード・ファクタ(0.75)と、指定したMapのマッピングを保持するのに十分な初期容量で作成されます。

パラメータ:

m - マッピングがこのマップに配置されるマップ

スロー:

NullPointerException - 指定されたマップがnullの場合

メソッドの詳細

size

public int size()

このマップ内のキー値マッピングの数を返します。

定義:

インタフェースMap<K,V>内のsize

オーバーライド:

クラスAbstractMap<K,V>のsize

戻り値:

このマップ内のキーと値のマッピングの数

isEmpty

public boolean isEmpty()

このマップがキーと値のマッピングを保持しない場合にtrueを返します。

定義:

インタフェースMap<K,V>内のisEmpty

オーバーライド:

クラスAbstractMap<K,V>のisEmpty

戻り値:

このマップがキーと値のマッピングを保持しない場合はtrue

get

public V get(Object key)

指定されたキーがマップされている値を返します。そのキーのマッピングがこのマップに含まれていない場合はnullを返します。

つまり、このメソッドは、(key==null ? k==null : key.equals(k))となるキーkから値vへのマッピングがこのマップに含まれている場合はvを返し、それ以外の場合はnullを返します。 (このようなマッピングは1つのみ存在できます。)

戻り値nullは、マップがキーのマッピングを保持していないことを示すとはかぎりません。つまり、マップが明示的にキーをnullにマップすることもあります。 containsKey操作を使うと、これら2つのケースを見分けることができます。

定義:

インタフェースMap<K,V>内のget

オーバーライド:

クラスAbstractMap<K,V>のget

パラメータ:

key - 関連付けられた値が返されるキー

戻り値:

指定されたキーがマップされている値。そのキーのマッピングがこのマップに含まれていない場合はnull

関連項目:

• put(Object, Object)

containsKey

public boolean containsKey(Object key)

指定されたキーのマッピングがこのマップに含まれている場合にtrueを返します。

定義:

インタフェースMap<K,V>内のcontainsKey

オーバーライド:

クラスAbstractMap<K,V>のcontainsKey

パラメータ:

key - このマップ内にあるかどうかが判定されるキー

戻り値:

指定されたキーのマッピングがこのマップに含まれている場合はtrue

put

public V put(K key, V value)

指定された値と指定されたキーをこのマップに関連付けます。 マップが以前にこのキーのマッピングを保持していた場合、古い値が置き換えられます。

定義:

インタフェースMap<K,V>内のput

オーバーライド:

クラスAbstractMap<K,V>のput

パラメータ:

key - 指定された値が関連付けられるキー

value - 指定されたキーに関連付けられる値

戻り値:

keyに以前に関連付けられていた値。keyのマッピングが存在しなかった場合はnull。 (戻り値nullは、マップが以前にnullとkeyを関連付けていたことを示す場合もある)

putAll

public void putAll(Map<? extends K, ? extends V> m)

指定されたマップからすべてのマッピングをマップにコピーします。 これにより、マップが指定されたマップ内に現在あるキーのすべてに対して持っていたマッピングが置き換えられます。

定義:

インタフェースMap<K,V>内のputAll

オーバーライド:

クラスAbstractMap<K,V>のputAll

パラメータ:

m - このマップに格納されるマッピング

スロー:

NullPointerException - 指定されたマップがnullの場合

remove

public V remove(Object key)

指定されたキーのマッピングがあればマップから削除します。

定義:

インタフェースMap<K,V>内のremove

オーバーライド:

クラスAbstractMap<K,V>のremove

パラメータ:

key - マッピングがマップから削除されるキー

戻り値:

keyに以前に関連付けられていた値。keyのマッピングが存在しなかった場合はnull。 (戻り値nullは、マップが以前にnullとkeyを関連付けていたことを示す場合もある)

clear

public void clear()

すべてのマッピングをマップから削除します。 この呼出しが戻ると、マップは空になります。

定義:

インタフェースMap<K,V>内のclear

オーバーライド:

クラスAbstractMap<K,V>のclear

containsValue

public boolean containsValue(Object value)

このマップが1つまたは複数のキーと指定された値をマッピングしている場合にtrueを返します。

定義:

インタフェースMap<K,V>内のcontainsValue

オーバーライド:

クラスAbstractMap<K,V>のcontainsValue

パラメータ:

value - このマップにあるかどうかが判定される値

戻り値:

このマップが1つまたは複数のキーを指定された値にマッピングしている場合はtrue

keySet

public Set<K> keySet()

このマップに含まれるキーのSetビューを返します。 セットはマップと連動しているので、マップに対する変更はセットに反映され、また、セットに対する変更はマップに反映されます。 セットの反復処理中にマップが変更された場合、反復処理の結果は定義されていません(イテレータ自身のremoveオペレーションを除く)。 セットは要素の削除をサポートします。Iterator.remove、Set.remove、removeAll、retainAll、およびclearオペレーションで対応するマッピングをマップから削除します。 addまたはaddAll操作はサポートされていません。

定義:

インタフェースMap<K,V>内のkeySet

オーバーライド:

クラスAbstractMap<K,V>のkeySet

戻り値:

マップに含まれているキーのセット・ビュー

values

public Collection<V> values()

このマップに含まれる値のCollectionビューを返します。 コレクションはマップと連動しているので、マップに対する変更はコレクションに反映され、またコレクションに対する変更はマップに反映されます。 コレクションの反復処理中にマップが変更された場合、反復処理の結果は定義されません(イテレータ自身のremoveオペレーションを除く)。 コレクションは要素の削除をサポートしており、対応するマッピングをマップから削除できます。削除は、Iterator.remove、Collection.remove、removeAll、retainAll、およびclearオペレーションを通して行います。 addまたはaddAll操作はサポートされていません。

定義:

インタフェースMap<K,V>内のvalues

オーバーライド:

クラスAbstractMap<K,V>のvalues

戻り値:

このマップに含まれている値のビュー

entrySet

public Set<Map.Entry<K,V>> entrySet()

このマップに含まれるマッピングのSetビューを返します。 セットはマップと連動しているので、マップに対する変更はセットに反映され、また、セットに対する変更はマップに反映されます。 セットの反復処理中にマップが変更された場合、反復処理の結果は定義されません(イテレータ自身のremoveオペレーション、またはイテレータにより返されるマップ・エントリに対するsetValueオペレーションを除く)。 セットは要素の削除をサポートしており、対応するマッピングをマップから削除できます。削除は、Iterator.remove、Set.remove、removeAll、retainAll、およびclearオペレーションを通して行います。 addまたはaddAll操作はサポートされていません。

定義:

インタフェースMap<K,V>内のentrySet

戻り値:

マップ内に保持されているマッピングのセット・ビュー

computeIfAbsent

public V computeIfAbsent(K key, Function<? super K, ? extends V> mappingFunction)

指定されたキーが値(または、nullにマップされます。)にまだ関連付けられていない場合、指定されたマッピング関数を使用してその値をコンピュートし、null (オプションの操作)でないかぎりこのマップに入力します。

マッピング関数がnullを返す場合、マッピングは記録されません。 マッピング関数自体が(unchecked)例外をスローした場合、例外は再スローされ、マッピングは記録されません。 もっとも一般的な用途は、次のように初期のマップされた値またはメモ化された結果として機能する新しいオブジェクトを構築することです。

map.computeIfAbsent(key, k -> new Value(f(k)));

または、1つのキーで複数の値をサポートする複数値マップMap<K,Collection<V>>を実装することです。

map.computeIfAbsent(key, k -> new HashSet<V>()).add(v);

マッピング関数は、計算中にこのマップを変更しないでください。

このメソッドは、マッピング関数によって計算中にこのマップが変更されることが検出された場合に、ベスト・エフォート・ベースでConcurrentModificationExceptionをスローします。

定義:

インタフェースMap<K,V>内のcomputeIfAbsent

パラメータ:

key - 指定された値が関連付けられるキー

mappingFunction - 値をコンピュートするマッピング関数

戻り値:

指定されたキーに関連付けられている現在の(既存の、または計算された)値。計算された値がnullである場合はnull

スロー:

ConcurrentModificationException - マップ機能がこのマップを変更したことが検出された場合

computeIfPresent

public V computeIfPresent(K key, BiFunction<? super K, ? super V, ? extends V> remappingFunction)

指定されたキーの値が存在し、null以外の場合は、キーとその現在のマップされた値(オプションの操作)を指定して、新しいマッピングのコンピュートを試みます。

再マッピング関数がnullを返す場合、マッピングは削除されます。 再マッピング関数自体が(unchecked)例外をスローした場合、例外は再スローされ、現在のマッピングは変更されません。

再マッピング関数は、計算中にこのマップを変更しないでください。

このメソッドは、再マッピング関数によって計算中にこのマップが変更されることが検出された場合に、ベスト・エフォート・ベースでConcurrentModificationExceptionをスローします。

定義:

インタフェースMap<K,V>内のcomputeIfPresent

パラメータ:

key - 指定された値が関連付けられるキー

remappingFunction - 値をコンピュートするための再マップ関数

戻り値:

指定されたキーに関連付けられる新しい値。存在しない場合はnull

スロー:

ConcurrentModificationException - リマッピング機能がこのマップを変更したことが検出された場合

compute

public V compute(K key, BiFunction<? super K, ? super V, ? extends V> remappingFunction)

指定されたキーとその現在のマップされた値のマッピングをコンピュートしようとします。現在のマッピング(オプションの操作)がない場合はnullです。 たとえば、次のように、値のマッピングにString msgを作成または追加します。

map.compute(key, (k, v) -> (v == null) ? msg : v.concat(msg))

(このような目的で使用するmerge()メソッドは、多くの場合、より単純です。)

再マッピング関数がnullを返した場合、マッピングは削除されます。(最初に欠席した場合は不在のままです)。 再マッピング関数自体が(unchecked)例外をスローした場合、例外は再スローされ、現在のマッピングは変更されません。

再マッピング関数は、計算中にこのマップを変更しないでください。

このメソッドは、再マッピング関数によって計算中にこのマップが変更されることが検出された場合に、ベスト・エフォート・ベースでConcurrentModificationExceptionをスローします。

定義:

インタフェースMap<K,V>内のcompute

パラメータ:

key - 指定された値が関連付けられるキー

remappingFunction - 値をコンピュートするための再マップ関数

戻り値:

指定されたキーに関連付けられる新しい値。存在しない場合はnull

スロー:

ConcurrentModificationException - リマッピング機能がこのマップを変更したことが検出された場合

merge

public V merge(K key, V value, BiFunction<? super V, ? super V, ? extends V> remappingFunction)

指定されたキーがまだ値に関連付けられていない場合、またはnullに関連付けられている場合は、指定されたnull以外の値(オプションの操作)に関連付けます。 それ以外の場合は、指定された再マッピング関数の結果で関連する値を置換し、結果がnullの場合は削除します。 このメソッドは、1つのキーに対する複数のマップされた値を結合するときに使用できます。 たとえば、次のように、値のマッピングにString msgを作成または追加します。

map.merge(key, msg, String::concat)

再マッピング関数がnullを返す場合、マッピングは削除されます。 再マッピング関数自体が(unchecked)例外をスローした場合、例外は再スローされ、現在のマッピングは変更されません。

再マッピング関数は、計算中にこのマップを変更しないでください。

このメソッドは、再マッピング関数によって計算中にこのマップが変更されることが検出された場合に、ベスト・エフォート・ベースでConcurrentModificationExceptionをスローします。

定義:

インタフェースMap<K,V>内のmerge

パラメータ:

key - 結果値が関連付けられるキー

value - キーに関連付けられた既存の値にマージされるnull以外の値。既存の値がない場合、またはキーにnull値が関連付けられている場合は、キーに関連付けられるnull以外の値

remappingFunction - 存在する場合に値を再計算するための再マッピング関数

戻り値:

指定されたキーに関連付けられた新しい値。キーに値が関連付けられなかった場合はnull

スロー:

ConcurrentModificationException - リマッピング機能がこのマップを変更したことが検出された場合

clone

public Object clone()

このHashMapインスタンスのシャロー・コピーを返します: キーと値自体はクローンされません。

オーバーライド:

クラスAbstractMap<K,V>のclone

戻り値:

このマップのシャロー・コピー

関連項目:

• Cloneable

newHashMap

public static <K,V> HashMap<K,V> newHashMap(int numMappings)

必要なマッピング数に適した新しい空のHashMapを作成します。 返されるマップではデフォルトのロード係数0.75が使用され、初期容量は通常十分に大きいため、マップのサイズを変更せずに必要な数のマッピングを追加できます。

型パラメータ:

K - 新しいマップによって保持されるキーのタイプ

V - マップされた値のタイプ

パラメータ:

numMappings - マッピングの予想数

戻り値:

新しく作成されたマップ

スロー:

IllegalArgumentException - numMappingsが負の場合

導入されたバージョン:

19