Интерфейс 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().

С:

1.0

См. также:

Краткое описание методов

Модификатор и тип	Метод	Описание
`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.

Возвращает:

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

С:

© 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/Enumeration.html