java.util
Interface Enumeration<E>

All Known Subinterfaces:
NamingEnumeration sample code for javax.naming.NamingEnumeration definition code for javax.naming.NamingEnumeration <T>
All Known Implementing Classes:
StringTokenizer sample code for java.util.StringTokenizer definition code for java.util.StringTokenizer

public interface Enumeration<E>

An object that implements the Enumeration interface generates a series of elements, one at a time. Successive calls to the nextElement method return successive elements of the series.

For example, to print all elements of a vector v:

     for (Enumeration e = v.elements() ; e.hasMoreElements() ;) {
         System.out.println(e.nextElement());
}

Methods are provided to enumerate through the elements of a vector, the keys of a hashtable, and the values in a hashtable. Enumerations are also used to specify the input streams to a SequenceInputStream.

NOTE: The functionality of this interface is duplicated by the Iterator interface. In addition, Iterator adds an optional remove operation, and has shorter method names. New implementations should consider using Iterator in preference to Enumeration.

Since:
JDK1.0
See Also:
Iterator sample code for java.util.Iterator definition code for java.util.Iterator , SequenceInputStream sample code for java.io.SequenceInputStream definition code for java.io.SequenceInputStream , nextElement() sample code for java.util.Enumeration.nextElement() definition code for java.util.Enumeration.nextElement() , Hashtable sample code for java.util.Hashtable definition code for java.util.Hashtable , Hashtable.elements() sample code for java.util.Hashtable.elements() definition code for java.util.Hashtable.elements() , Hashtable.keys() sample code for java.util.Hashtable.keys() definition code for java.util.Hashtable.keys() , Vector sample code for java.util.Vector definition code for java.util.Vector , Vector.elements() sample code for java.util.Vector.elements() definition code for java.util.Vector.elements()

Method Summary
 boolean hasMoreElements sample code for java.util.Enumeration.hasMoreElements() definition code for java.util.Enumeration.hasMoreElements() ()
          Tests if this enumeration contains more elements.
 E nextElement sample code for java.util.Enumeration.nextElement() definition code for java.util.Enumeration.nextElement() ()
          Returns the next element of this enumeration if this enumeration object has at least one more element to provide.
 

Method Detail

hasMoreElements sample code for java.util.Enumeration.hasMoreElements() definition code for java.util.Enumeration.hasMoreElements()

boolean hasMoreElements()
Tests if this enumeration contains more elements.

Returns:
true if and only if this enumeration object contains at least one more element to provide; false otherwise.

nextElement sample code for java.util.Enumeration.nextElement() definition code for java.util.Enumeration.nextElement()

E nextElement()
Returns the next element of this enumeration if this enumeration object has at least one more element to provide.

Returns:
the next element of this enumeration.
Throws:
NoSuchElementException sample code for java.util.NoSuchElementException definition code for java.util.NoSuchElementException - if no more elements exist.