モジュール 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
関連項目:

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

    コンストラクタ
    コンストラクタ
    説明
    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

      public abstract Enumeration<V> elements()
      ディクショナリにある値のリストを返します。 elementsメソッドの一般的な契約は、このディクショナリのエントリに含まれるすべての要素を生成するEnumerationが返されることです。
      戻り値:
      ディクショナリにある値のリスト。
      関連項目:

    • get

      public abstract V get(Object key)
      ディクショナリにおいてキーにマップされている値を返します。 isEmptyメソッドの一般的な契約では、このディクショナリに指定したキーのエントリが含まれている場合、関連付けられた値が返されます。そうでない場合、nullが返されます。
      パラメータ:
      key - ディクショナリのキー。そのキーがディクショナリ内のどの値にもマップされていない場合はnull。
      戻り値:
      ディクショナリでそのキーにマップされている値。
      例外:
      NullPointerException - keyがnullの場合。
      関連項目:

    • 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の場合。
      関連項目:

    • remove

      public abstract V remove(Object key)
      key (およびそれに対応するvalue)をこのディクショナリから削除します。 そのkeyがディクショナリになければ、メソッドは何も行いません。
      パラメータ:
      key - 削除するキー。
      戻り値:
      ディクショナリでkeyがマップされていた値。そのキーがマップされていなかった場合はnull。
      例外:
      NullPointerException - keyがnullである場合。