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

java.lang.Object
  java.util.Dictionary<K,V>
      java.util.Hashtable<K,V>

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

Map<K,V>

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

Properties

public class Hashtable<K,V>
extends Dictionary<K,V>
implements Map<K,V>

Hashtable は、キーから値への関連付けを行うハッシュテーブルを実装しています。

Hashtable では null をキーおよび値として使用できません。 このクラスのメソッドにキーまたは値として null が指定された場合、NullPointerException がスローされます。

Hashtable クラスの実装は内部同期されており、スレッドセーフです。 すなわち、複数のスレッドから同時並行的に同一の Hashtable を操作（メソッド呼び出し）してもその内部状態の整合性は保持されます。 これは、個々のメソッド単位の操作では整合性が保たれるという意味です。 もし一連のメソッド呼び出しにわたって別スレッドからの干渉を防ぐ必要がある場合は外部同期が必要です。

なお、elements メソッドまたは keys メソッドで得られる Enumeration からの Hashtable へのアクセスは同期されていないため、スレッドセーフではありません。並行して非同期に Hashtable の内容が変更される状況下ではこれらを使うことはできません。

入れ子のクラスの概要

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

Map.Entry<K,V>

コンストラクタの概要

Hashtable()
空のハッシュテーブルをデフォルトのエントリ容量11で作成します。

Hashtable(int initialCapacity)
指定されたエントリ容量の、空のハッシュテーブルを作成します。

メソッドの概要

void	clear() このハッシュテーブルからすべてのエントリを除去します。
boolean	containsKey(Object key) このハッシュテーブルが指定されたキーのエントリを保持しているかどうか判定します。
boolean	containsValue(Object value) このハッシュテーブルが、指定された値にキーを関連づけるエントリを保持しているかどうか判定します。
Enumeration<V>	elements() このハッシュテーブルのすべての値を列挙する Enumeration を返します。
Set<Map.Entry<K,V>>	entrySet() このハッシュテーブルに含まれるエントリの Set ビューを返します。
V	get(Object key) このハッシュテーブルで指定されたキーに関連付けられている値を返します。
boolean	isEmpty() このハッシュテーブルが空かどうかを判定します。
Enumeration<K>	keys() このハッシュテーブルのすべてのキーを列挙する Enumeration を返します。
V	put(K key, V value) 指定されたキーと値をこのハッシュテーブルで関連付けます。
V	remove(Object key) 指定されたキーのエントリを除去します。
int	size() このハッシュテーブルが保持するエントリの数を返します。
String	toString() このハッシュテーブルの文字列表現を返します。

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

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

コンストラクタの詳細

Hashtable

public Hashtable()

空のハッシュテーブルをデフォルトのエントリ容量11で作成します。

Hashtable

public Hashtable(int initialCapacity)

指定されたエントリ容量の、空のハッシュテーブルを作成します。

パラメータ:

initialCapacity - 初期エントリー容量

例外:

IllegalArgumentException - initialCapacity が負値の場合

メソッドの詳細

containsKey

public boolean containsKey(Object key)

このハッシュテーブルが指定されたキーのエントリを保持しているかどうか判定します。 キーの同一性は equals メソッドによって判定されます。

定義:

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

パラメータ:

key - キー

戻り値:

このハッシュテーブルが指定されたキーのエントリを保持している場合 true 。 保持していない場合 false 。

例外:

NullPointerException - key が null の場合。

containsValue

public boolean containsValue(Object value)

このハッシュテーブルが、指定された値にキーを関連づけるエントリを保持しているかどうか判定します。 値の同一性は equals メソッドによって判定されます。

定義:

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

パラメータ:

value - 値

戻り値:

このハッシュテーブルが、指定された値にキーを関連づけるエントリを保持している場合 true、保持していない場合 false

例外:

NullPointerException - value が null の場合。

get

public V get(Object key)

このハッシュテーブルで指定されたキーに関連付けられている値を返します。

定義:

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

定義:

クラス Dictionary<K,V> 内の get

パラメータ:

key - キー

戻り値:

keyに関連づけられている値。 key をキーとするエントリが存在していない場合は null 。

例外:

NullPointerException - key が null の場合。

remove

public V remove(Object key)

指定されたキーのエントリを除去します。 指定されたキーのエントリが存在しない場合、このメソッドは何もせずに null を返します。

定義:

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

定義:

クラス Dictionary<K,V> 内の remove

パラメータ:

key - キー

戻り値:

key に関連づけられていた値。 指定されたキーのエントリが存在しない場合、null 。

例外:

NullPointerException - key が null の場合。

put

public V put(K key,
             V value)

指定されたキーと値をこのハッシュテーブルで関連付けます。

このハッシュテーブルが指定されたキーのエントリを保持していない場合、新たなエントリとしてこのハッシュテーブルに追加されます。 このハッシュテーブルが指定されたキーのエントリを保持していた場合、そのエントリの値を指定された値で入れ替えます。

定義:

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

定義:

クラス Dictionary<K,V> 内の put

パラメータ:

key - キー

value - 値

戻り値:

key に関連付けされていた以前の値。 key をキーとするエントリが存在していない場合は null 。

例外:

NullPointerException - key または value が null の場合。

size

public int size()

このハッシュテーブルが保持するエントリの数を返します。

定義:

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

定義:

クラス Dictionary<K,V> 内の size

戻り値:

このハッシュテーブルが保持するエントリの数

isEmpty

public boolean isEmpty()

このハッシュテーブルが空かどうかを判定します。

定義:

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

戻り値:

このハッシュテーブルが空の場合 true、そうでない場合 false

clear

public void clear()

このハッシュテーブルからすべてのエントリを除去します。

定義:

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

toString

public String toString()

このハッシュテーブルの文字列表現を返します。

オーバーライド:

クラス Object 内の toString

戻り値:

このハッシュテーブルの文字列表現

entrySet

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

このハッシュテーブルに含まれるエントリの Set ビューを返します。 この Set では、iterator メソッドだけ実装されています。 また、この iterator メソッドが返す Iterator では remove メソッドをサポートしておらず、 UnsupportedOperationException をスローします。

定義:

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

戻り値:

このハッシュテーブルに含まれるマッピングの Set ビュー

関連項目:

Map.entrySet()

keys

public Enumeration<K> keys()

このハッシュテーブルのすべてのキーを列挙する Enumeration を返します。

定義:

クラス Dictionary<K,V> 内の keys

戻り値:

このハッシュテーブルのすべてのキーを列挙する Enumeration

elements

public Enumeration<V> elements()

このハッシュテーブルのすべての値を列挙する Enumeration を返します。

戻り値:

このハッシュテーブルのすべての値を列挙する（キー・値の関連付けすべてについて値を列挙する） Enumeration