Iterator

Overview

Package

Class

Use

Deprecated

Index

Home >> All >> java >> [ util overview ]

PREV CLASS NEXT CLASS

SUMMARY:

JAVADOC |

SOURCE |

DOWNLOAD | NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

java.util
Interface Iterator

All Known Subinterfaces:: ListIterator

All Known Implementing Classes:: Collections.SynchronizedIterator, Collections.SynchronizedListIterator, Collections.UnmodifiableIterator, Collections.UnmodifiableListIterator, HashMap.HashIterator, Hashtable.EntryIterator, IdentityHashMap.IdentityIterator, LinkedList.LinkedListItr, TreeMap.TreeIterator

public interface Iterator

An object which iterates over a collection. An Iterator is used to return the items once only, in sequence, by successive calls to the next method. It is also possible to remove elements from the underlying collection by using the optional remove method. Iterator is intended as a replacement for the Enumeration interface of previous versions of Java, which did not have the remove method and had less conveniently named methods.

Since:: 1.2

Method Summary

boolean hasNext()
          Tests whether there are elements remaining in the collection.

java.lang.Object next()
          Obtain the next element in the collection.

void remove()
          Remove from the underlying collection the last element returned by next (optional operation).

Method Detail

hasNext

public boolean hasNext()

Tests whether there are elements remaining in the collection. In other words, calling next() will not throw an exception.

public java.lang.Object next()

Obtain the next element in the collection.

remove

public void remove()

Remove from the underlying collection the last element returned by next (optional operation). This method can be called only once after each call to next(). It does not affect what will be returned by subsequent calls to next.