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

Параметры типа:: 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 этого Enumeration, метод next которого вызывает метод nextElement этого Enumeration, а метод remove которого вызывает исключение UnsupportedOperationException.

Возвращает:

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

С версии:

© 1993, 2025, 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/25/docs/api/java.base/java/util/Enumeration.html