Интерфейс Enumeration<E>

Все известные подинтерфейсы:: NamingEnumeration<T>

Все известные реализующие классы:: StringTokenizer

public interface Enumeration<E>

Объект, реализующий интерфейс Enumeration, генерирует серию элементов по одному за раз. Последовательные вызовы метода nextElement возвращают последовательные элементы серии.

Например, чтобы вывести все элементы Vector<E> v:

for (Enumeration<E> e = v.elements(); e.hasMoreElements();)
       System.out.println(e.nextElement());

Предоставляются методы для перечисления элементов вектора, ключей хеш-таблицы и значений в хеш-таблице. Перечисления также используются для указания входных потоков в SequenceInputStream.

Примечание API:: Функциональность этого интерфейса дублируется интерфейсом Iterator. Кроме того, Iterator добавляет необязательную операцию удаления и имеет более короткие имена методов. Новые реализации должны использовать Iterator вместо Enumeration. Возможна адаптация Enumeration к Iterator с помощью метода asIterator().
C момента:: 1.0
См. также:: Iterator, SequenceInputStream, nextElement(), Hashtable, Hashtable.elements(), Hashtable.keys(), Vector, Vector.elements()

Методы

Модификатор и тип	Метод	Описание
`default Iterator<E>`	`asIterator()`	Возвращает `Iterator`, который проходит по оставшимся элементам, охватываемым этим перечислением.
`boolean`	`hasMoreElements()`	Проверяет, содержит ли это перечисление ещё элементы.
`E`	`nextElement()`	Возвращает следующий элемент этого перечисления, если этот объект перечисления имеет ещё хотя бы один элемент для предоставления.

Методы

hasMoreElements

boolean hasMoreElements()

Проверяет, содержит ли это перечисление ещё элементы.

Возвращает:: true тогда и только тогда, когда этот объект перечисления содержит по крайней мере один дополнительный элемент для предоставления; false в противном случае.

nextElement

E nextElement()

Возвращает следующий элемент этого перечисления, если этот объект перечисления имеет ещё хотя бы один элемент для предоставления.

Возвращает:: следующий элемент этого перечисления.
Исключение:: NoSuchElementException - если больше нет элементов.

asIterator

default Iterator<E> asIterator()

Возвращает Iterator, который проходит по оставшимся элементам, охватываемым этим перечислением. Проход не определен, если какие-либо методы вызываются на этом перечислении после вызова asIterator.

Примечание API:

Этот метод предназначен для адаптации кода, который производит Enumeration экземпляры к коду, который потребляет Iterator экземпляры. Например, метод JarFile.entries() возвращает Enumeration<JarEntry> экземпляр. Это можно преобразовать в Iterator экземпляр, а затем использовать метод forEachRemaining():

JarFile jarFile = ... ;
     jarFile.entries().asIterator().forEachRemaining(entry -> { ... });

(Обратите внимание, что также существует метод JarFile.stream(), который возвращает Stream записей, что может быть удобнее в некоторых случаях).

Требования реализации:

Реализация по умолчанию возвращает Iterator , чьи метод hasNext вызывает метод hasMoreElements этого перечисления, метод next вызывает метод nextElement этого перечисления, а метод remove выбрасывает UnsupportedOperationException.

Возвращает:

итератор, представляющий оставшиеся элементы этого перечисления

C момента: