Enumeration : Java Glossary

Enumeration

An Enumeration is the old-style interface for going through the elements of a some sort of collection (but not a Collection) one by one. You use the Enumeration object once, then discard it.

Sample Code	Implementing
Generics	Learning More
Enumeration vs Iterator	Links

Sample Code

You use it like this:

Generics

Enumeration has been updated to work with generics like this:

Enumeration vs Iterator

Enumeration was the forerunner of Iterator. Iterator was introduced in JDK 1.2. New classes use Iterator but the old timers still support Enumeration. You will see Enumerations in Hashtable. elements, Properties. element and Vector. elements.

If the class of interest supports both Iterator and Enumeration, use Iterator.

Enumeration vs Iterator
Enumeration	Iterator Equivalent	Notes
Enumeration	Iterator	The name of the interface the doles out the elements one by one.
Hashtable.elements Properties.propertyNames Vector.elements	Collection.iterator	Typical name of method that provides the Enumeration or Iterator.
Enumeration.hasMoreElements	Iterator.hasNext	Are there more elements to come?
Enumeration.nextElement	Iterator.next	next element
	java.lang.Iterable	Interface noting that this class is capable of emitting an Iterator with the iterator method.
		Works in a for:each statement, e. g. for ( String value : someCollection )

Implementing

Implementing an Enumeration is much simpler than you might suppose. Just look at the code for some of the existing Enumerations and Iterators.

Learning More

Sun’s Javadoc on Enumeration interface : available:

on the web at java.sun.com
in the current JDK 1.6.0_17 or in the old JDK 1.5.0_22 on your local Windows J: drive.

Sun’s Javadoc on Iterator interface : available:

on the web at java.sun.com
in the current JDK 1.6.0_17 or in the old JDK 1.5.0_22 on your local Windows J: drive.

Sun’s Javadoc on Iterable interface : available:

on the web at java.sun.com
in the current JDK 1.6.0_17 or in the old JDK 1.5.0_22 on your local Windows J: drive.

Hashtable
Iterator
Properties
Vector

	You can get the freshest copy of this page from:	or possibly from your local J: drive (Java virtual drive/mindprod.com website mirror)
	http://mindprod.com/jgloss/enumeration.html	J:\mindprod\jgloss\enumeration.html
	Please email your feedback for publication, errors, omissions, typos, formatting errors, ambiguities, unclear wording, broken/redirected link reports, suggestions to improve this page or comments to Roedy Green :
	Canadian Mind Products
	mindprod.com IP:[65.110.21.43]
view Blog	Your face IP:[38.107.191.104]
Feedback	You are visitor number 25,886.