-
- All Known Subinterfaces:
-
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 Note:
-
该接口的功能由
Iterator
接口复制。 此外,Iterator
添加了可选的删除操作,并且具有较短的方法名称。 新实现应考虑使用Iterator
而不是Enumeration
。 因此能够适应一个Enumeration
到Iterator
通过使用asIterator()
方法。 - 从以下版本开始:
- 1.0
- 另请参见:
-
Iterator
,SequenceInputStream
,nextElement()
,Hashtable
,Hashtable.elements()
,Hashtable.keys()
,Vector
,Vector.elements()
-
-
方法摘要
所有方法 实例方法 抽象方法 Default Methods 变量和类型 方法 描述 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
之后在此枚举上调用了任何方法,则asIterator
。- API Note:
-
此方法旨在帮助将生成
Enumeration
实例的代码调整为消耗Iterator
实例的代码。 例如,JarFile.entries()
方法返回Enumeration<JarEntry>
。 这可以变成Iterator
,然后可以使用forEachRemaining()
方法:JarFile jarFile = ... ; jarFile.entries().asIterator().forEachRemaining(entry -> { ... });
JarFile.stream()
方法可以返回Stream
条目,在某些情况下可能更方便。) - 实现要求:
-
默认实现返回
Iterator
其hasNext
方法调用此Enumeration的hasMoreElements
方法,其next
方法调用此Enumeration的nextElement
方法,其remove
方法抛出UnsupportedOperationException
。 - 结果
- 表示此枚举的其余元素的迭代器
- 从以下版本开始:
- 9
-
-