java.util
クラス HashMap<K,V>

java.lang.Object
  java.util.HashMap<K,V>

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

Map<K,V>

public class HashMap<K,V>
extends Object
implements Map<K,V>

HashMap はハッシュテーブルをベースとした Map インタフェースの実装です。

HashMap では null をキーおよび値として使用できます。

入れ子のクラスの概要

static class

HashMap.SimpleEntry<K,V> HashMap.SimpleEntry は HashMap の個々のマップエントリを表します。

インタフェース java.util.Map から継承された入れ子のクラス/インタフェース

Map.Entry<K,V>

コンストラクタの概要

HashMap()
空の HashMap をデフォルトのエントリ容量16で作成します。

HashMap(int initialCapacity)
指定されたエントリ容量の、空の HashMap を作成します。

メソッドの概要

void	clear() この HashMap からすべてのマッピングを除去します。
boolean	containsKey(Object key) 指定された値に関連付けるマッピングがこの HashMap に含まれているかどうかを判定します。
boolean	containsValue(Object value) 指定された値に関連付けるマッピングがこのマップに含まれているかどうかを判定します。
Set<Map.Entry<K,V>>	entrySet() この HashMap に含まれるマッピングの Set ビューを返します。
V	get(Object key) この Map で指定されたキーに関連付けている値を返します。
boolean	isEmpty() この Map がマッピングを保持していない場合 true、保持している場合 false を返します。
V	put(K key, V value) 指定された値を、指定されたキーの値としてこの Map で関連付けます。
V	remove(Object key) この HashMap から、指定されたキーのマッピングを除去します。
int	size() この Map が保持しているマッピングの数を返します。
String	toString() この HashMap の文字列表現を返します。

クラス java.lang.Object から継承されたメソッド

equals, getClass, hashCode, notify, notifyAll, wait, wait

コンストラクタの詳細

HashMap

public HashMap()

空の HashMap をデフォルトのエントリ容量16で作成します。

HashMap

public HashMap(int initialCapacity)

指定されたエントリ容量の、空の HashMap を作成します。

パラメータ:

initialCapacity - 初期エントリー容量。 このパラメータに0を指定した場合でも例外は発生しませんが、 そのオブジェクトを使用した場合の振る舞いは保証されません。

例外:

IllegalArgumentException - initialCapacity が負値の場合

メソッドの詳細

containsKey

public boolean containsKey(Object key)

指定された値に関連付けるマッピングがこの HashMap に含まれているかどうかを判定します。

定義:

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

パラメータ:

key - マッピングのキー

戻り値:

指定されたキーのマッピングがこの Map に含まれていたら true、含まれていなかったら false

containsValue

public boolean containsValue(Object value)

指定された値に関連付けるマッピングがこのマップに含まれているかどうかを判定します。

定義:

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

パラメータ:

value - マッピングの値

戻り値:

指定された値に関連付けるマッピングがこのマップに含まれていたら true、含まれていなかったら false

get

public V get(Object key)

この Map で指定されたキーに関連付けている値を返します。

指定されたキーのマッピングが無い場合 null を返します。 null が返った場合、指定されたキーに null が関連付けられている可能性もあります。 このケースかどうかは containsKey(java.lang.Object) メソッドで判定できます。

定義:

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

パラメータ:

key - キー

戻り値:

key に関連づけられている値。 key のマッピングが無い場合 null 。

put

public V put(K key,
             V value)

指定された値を、指定されたキーの値としてこの Map で関連付けます。

定義:

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

パラメータ:

key - キー

value - キーに関連づける値

戻り値:

key をキーとするマッピングが存在していた場合、関連付けられていた以前の値が返ります。 key をキーとするマッピングが存在していなかった場合、null が返ります。 null が返った場合、null がマッピングされていた可能性もあります。

remove

public V remove(Object key)

この HashMap から、指定されたキーのマッピングを除去します。 また、除去したマッピングの値を返します。

指定されたキーのマッピングが存在していなかった場合 null を返します。 null が返った場合、指定されたキーに null が関連付けられていた可能性もあります。

定義:

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

パラメータ:

key - キー

戻り値:

key に関連付けられていた値。 key のマッピングが無かった場合 null 。

size

public int size()

この Map が保持しているマッピングの数を返します。

このメソッドの詳細は Map#size の規約を参照してください。

定義:

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

戻り値:

この Map が保持しているマッピングの数

isEmpty

public boolean isEmpty()

この Map がマッピングを保持していない場合 true、保持している場合 false を返します。

定義:

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

戻り値:

この HashMap がマッピングを保持していない場合 true、保持している場合 false

clear

public void clear()

この HashMap からすべてのマッピングを除去します。

定義:

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

toString

public String toString()

この HashMap の文字列表現を返します。

オーバーライド:

クラス Object 内の toString

戻り値:

この HashMap の文字列表現

entrySet

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

この HashMap に含まれるマッピングの Set ビューを返します。 この Set では、iterator メソッドだけ実装されています。 なお、この iterator メソッドが返す Iterator では remove メソッドをサポートしておらず、 UnsupportedOperationException をスローします。

定義:

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

戻り値:

この HashMap に含まれるマッピングの Set ビュー

関連項目:

Map.entrySet()