sample/java.util.Iterator.txt

   1 *java.util.Iterator* *Iterator* An iterator over a collection.
   2
   3 public interface interface Iterator
   4
   5
   6 |java.util.Iterator_Description|
   7 |java.util.Iterator_Fields|
   8 |java.util.Iterator_Constructors|
   9 |java.util.Iterator_Methods|
  10
  11 ================================================================================
  12
  13 *java.util.Iterator_Methods*
  14 |java.util.Iterator.hasNext()|Returns true if the iteration has more elements.
  15 |java.util.Iterator.next()|Returns the next element in the iteration.
  16 |java.util.Iterator.remove()|Removes from the underlying collection the last el
  17
  18 *java.util.Iterator_Description*
  19
  20 An iterator over a collection. Iterator takes the place of Enumeration in the
  21 Java collections framework. Iterators differ from enumerations in two ways:
  22 Iterators allow the caller to remove elements from the underlying collection
  23 during the iteration with well-defined semantics. Method names have been
  24 improved.
  25
  26 This interface is a member of the <a href="/../guide/collections/index.html">
  27 Java Collections Framework.
  28
  29
  30 *java.util.Iterator.hasNext()*
  31
  32 public boolean hasNext()
  33
  34 Returns true if the iteration has more elements. (In other words, returns true
  35 if next would return an element rather than throwing an exception.)
  36
  37
  38     Returns: true if the iterator has more elements.
  39 *java.util.Iterator.next()*
  40
  41 public |java.lang.Object| next()
  42
  43 Returns the next element in the iteration. Calling this method repeatedly until
  44 the (|java.util.Iterator|) method returns false will return each element in the
  45 underlying collection exactly once.
  46
  47
  48     Returns: the next element in the iteration.
  49 *java.util.Iterator.remove()*
  50
  51 public void remove()
  52
  53 Removes from the underlying collection the last element returned by the
  54 iterator (optional operation). This method can be called only once per call to
  55 next. The behavior of an iterator is unspecified if the underlying collection
  56 is modified while the iteration is in progress in any way other than by calling
  57 this method.
  58
  59
  60