sample/java.util.Iterator.txt

   1 *java.util.Iterator* *Iterator* An iterator over a collection.
   2
   3 public interface interface Iterator<E>
   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
  27 href="/../technotes/guides/collections/index.html"> Java Collections Framework.
  28
  29
  30
  31 *java.util.Iterator.hasNext()*
  32
  33 public boolean hasNext()
  34
  35 Returns true if the iteration has more elements. (In other words, returns true
  36 if next would return an element rather than throwing an exception.)
  37
  38
  39
  40     Returns: true if the iterator has more elements.
  41
  42 *java.util.Iterator.next()*
  43
  44 public |E| next()
  45
  46 Returns the next element in the iteration.
  47
  48
  49
  50     Returns: the next element in the iteration.
  51
  52 *java.util.Iterator.remove()*
  53
  54 public void remove()
  55
  56 Removes from the underlying collection the last element returned by the
  57 iterator (optional operation). This method can be called only once per call to
  58 next. The behavior of an iterator is unspecified if the underlying collection
  59 is modified while the iteration is in progress in any way other than by calling
  60 this method.
  61
  62
  63
  64