Содержание | Предыдущий | Следующий | Индекс

21.4 Класс java.util.Dictionary

A Dictionary объект, который связывает элементы с ключами. Каждый ключ и каждый элемент являются объектом. В любом Dictionary, каждый ключ связывается самое большее один элемент. Данный a Dictionary и ключ, связанный элемент может искаться.

public abstract class Dictionary {
	abstract public int size();
	abstract public boolean isEmpty();
	abstract public Object get(Object key)
		throws NullPointerException;
	abstract public Object put(Object key, Object element)
		throws NullPointerException;
	abstract public Object remove(Object key)
		throws NullPointerException;
	abstract public Enumeration keys();
	abstract public Enumeration elements();
}
Как правило, equals метод (§20.1.3) должен использоваться реализациями класса Dictionary решить, являются ли два ключа тем же самым.

21.4.1 abstract public int size()

Общий контракт для size метод - то, что это возвращает число записей (отличные ключи) в этом словаре.

21.4.2 abstract public boolean isEmpty()

Общий контракт для isEmpty метод - то, что результат true если и только если этот словарь не содержит записей.

21.4.3 abstract public Object get(Object key)
throws NullPointerException

Общий контракт для isEmpty метод - это, если этот словарь содержит запись для указанного key, связанный элемент возвращается; иначе, null возвращается.

Если key null, a NullPointerException бросается.

21.4.4 abstract public Object put(Object key, Object element)
throws NullPointerException

Общий контракт для put метод - то, что это добавляет запись в этот словарь.

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

Если у этого словаря уже нет записи для указанного key, запись создается для указанного key и element, и null возвращается.

Если key или element null, a NullPointerException бросается.

21.4.5 abstract public Object remove(Object key)
throws NullPointerException

Общий контракт для remove метод - то, что это удаляет запись из этого словаря.

Если этот словарь содержит запись для указанного key, элемент в этом словаре для этого key возвращается, после удаления записи из этого словаря.

Если у этого словаря уже нет записи для указанного key, null возвращается.

Если key null, a NullPointerException бросается.

21.4.6 abstract public Enumeration keys()

Общий контракт для keys метод то, что Enumeration (§21.1) возвращается, который генерирует все ключи, для которых этот словарь содержит записи.

21.4.7 abstract public Enumeration elements()

Общий контракт для elements метод то, что Enumeration (§21.1) возвращается, который генерирует все элементы, содержавшиеся в записях в этом словаре.


Содержание | Предыдущий | Следующий | Индекс

Спецификация языка Java (HTML, сгенерированный Блинчиком "сюзет" Pelouch 24 февраля 1998)
Авторское право © Sun Microsystems, Inc 1996 года. Все права защищены
Пожалуйста, отправьте любые комментарии или исправления к doug.kramer@sun.com



Spec-Zone.ru - all specs in one place



free hit counter