Класс Dictionary<K,V>

java.lang.Object

java.util.Dictionary<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(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 может быть получен, вызвав метод 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, 2021, 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/17/docs/api/java.base/java/util/Dictionary.html