Класс Dictionary<K,V>

java.lang.Object

java.util.Dictionary<K,V>

Параметры типа:: K - тип ключей; V - тип сопоставленных значений

Прямые известные подклассы:: Hashtable

public abstract class Dictionary<K,V> extends Object

Класс Dictionary является абстрактным родителем любого класса, такого как Hashtable, который сопоставляет ключи значениям. Каждый ключ и каждое значение — это объект. В любом объекте Dictionary, каждый ключ сопоставляется с не более чем одним значением. Учитывая объект Dictionary и ключ, связанный элемент можно найти. Любой не-null объект может быть использован в качестве ключа и значения.

Как правило, метод 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 можно получить, вызвав метод get с key, который равен исходному key.

Параметры:

key - ключ хеш-таблицы.

value - значение.

Возвращает:

предыдущее значение, которому был сопоставлен key в этом словаре, или null если ключ не имел предыдущего сопоставления.

Исключения:

NullPointerException - если key или value является null.

См. также:

remove

public abstract V remove(Object key)

Удаляет key (и соответствующее value) из этого словаря. Этот метод ничего не делает, если key не находится в этом словаре.

Параметры:: key - ключ, который нужно удалить.
Возвращает:: значение, которому был сопоставлен key в этом словаре, или null если ключ не имел сопоставления.
Исключения:: NullPointerException - если key является null.

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Dictionary.html