モジュール java.base

パッケージ java.util

クラス Dictionary<K,V>

java.lang.Object

java.util.Dictionary<K,V>

型パラメータ:

K - キーの型

V - マップされる値の型

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

Hashtable

public abstract class Dictionary<K,V> extends Object

Dictionaryクラスは、Hashtableのようにキーを値にマップするクラスのabstract親です。 各キーおよび各値はオブジェクトです。 1つのDictionaryオブジェクトでは、すべてのキーが最大1つの値に関連付けられます。 Dictionaryとキーを指定すると、関連付けられた要素を検索できます。 キーや値としては、任意のnullでないオブジェクトが使用できます。

このクラスを実装している場合、2つのキーが等しいかどうかを判定するには、原則としてequalsメソッドを使用する必要があります。

ノート: このクラスは現在使われていません。 新しい実装では、このクラスを拡張しないでMapインタフェースを実装してください。

導入されたバージョン:

1.0

関連項目:

• Map
• Object.equals(java.lang.Object)
• Object.hashCode()
• Hashtable

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

コンストラクタ

コンストラクタ	説明
Dictionary()	唯一のコンストラクタです。

メソッドのサマリー

修飾子と型	メソッド	説明
abstract Enumeration<V>	elements()	ディクショナリにある値のリストを返します。
abstract V	get(Object key)	ディクショナリにおいてキーにマップされている値を返します。
abstract boolean	isEmpty()	値にマップされているキーが、ディクショナリにまったくないかどうかを判定します。
abstract Enumeration<K>	keys()	ディクショナリにあるキーの列挙を返します。
abstract V	put(K key, V value)	このディクショナリで、指定されたkeyを指定されたvalueにマップします。
abstract V	remove(Object key)	key (およびそれに対応するvalue)をこのディクショナリから削除します。
abstract int	size()	ディクショナリにあるエントリ(個別のキー)の数を返します。

クラスjava.lang.Objectで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

Dictionary

public Dictionary()

唯一のコンストラクタです。 (サブクラスのコンストラクタによる呼出し用で、通常は暗黙的に呼び出されます。)

メソッドの詳細

size

public abstract int size()

ディクショナリにあるエントリ(個別のキー)の数を返します。

戻り値:

ディクショナリにあるキーの数。

isEmpty

public abstract boolean isEmpty()

値にマップされているキーが、ディクショナリにまったくないかどうかを判定します。 isEmptyメソッドの一般的な契約は、このディクショナリにエントリが含まれていない場合にのみ結果がtrueになることです。

戻り値:

値にマップされているキーがディクショナリにない場合はtrue、ある場合はfalse。

keys

public abstract Enumeration<K> keys()

ディクショナリにあるキーの列挙を返します。 keysメソッドの一般的な契約は、このディクショナリにエントリが含まれているすべてのキーを生成するEnumerationオブジェクトが返されることです。

戻り値:

ディクショナリにあるキーの列挙。

関連項目:

• elements()
• Enumeration

elements

public abstract Enumeration<V> elements()

ディクショナリにある値のリストを返します。 elementsメソッドの一般的な契約は、このディクショナリのエントリに含まれるすべての要素を生成するEnumerationが返されることです。

戻り値:

ディクショナリにある値のリスト。

関連項目:

• keys()
• Enumeration

get

public abstract V get(Object key)

ディクショナリにおいてキーにマップされている値を返します。 isEmptyメソッドの一般的な契約では、このディクショナリに指定したキーのエントリが含まれている場合、関連付けられた値が返されます。そうでない場合、nullが返されます。

パラメータ:

key - ディクショナリのキー。そのキーがディクショナリ内のどの値にもマップされていない場合はnull。

戻り値:

ディクショナリでそのキーにマップされている値。

例外:

NullPointerException - keyがnullの場合。

関連項目:

• put(java.lang.Object, java.lang.Object)

put

public abstract V put(K key, V value)

このディクショナリで、指定されたkeyを指定されたvalueにマップします。 キーや値はnullにすることはできません。

このディクショナリに指定したkeyのエントリがすでに含まれている場合は、新しい要素を含むエントリを変更した後に、そのkeyのこのディクショナリにすでに存在する値が返されます。

このディクショナリに、指定されたkeyのエントリがまだない場合、指定されたkeyおよびvalueのエントリが作成され、nullが返されます。

valueを取得するには、元のkeyに等しいkeyを指定してgetメソッドを呼び出します。

パラメータ:

key - ハッシュ表キー。

value - 値

戻り値:

ディクショナリでkeyにマップされていた前の値。このキーに値がマップされていなかった場合はnull。

例外:

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

関連項目:

• Object.equals(java.lang.Object)
• get(java.lang.Object)

remove

public abstract V remove(Object key)

key (およびそれに対応するvalue)をこのディクショナリから削除します。 そのkeyがディクショナリになければ、メソッドは何も行いません。

パラメータ:

key - 削除するキー。

戻り値:

ディクショナリでkeyがマップされていた値。そのキーがマップされていなかった場合はnull。

例外:

NullPointerException - keyがnullである場合。