oracle.ide.util
Class DuplexIterator

java.lang.Object
  oracle.ide.util.DuplexIterator

All Implemented Interfaces:

java.util.Iterator

public class DuplexIterator

extends java.lang.Object

implements java.util.Iterator

The DuplexIterator class iterates contiguously over two other Iterators. Elements from the first Iterator are always returned before elements from the second Iterator. DuplexIterators may be chained to create a multiplexing iterator; for example:

    Iterator triplexIterator(Iterator iter1, Iterator iter2, Iterator iter3)
    {
      return new DuplexIterator(new DuplexIterator(iter1, iter2), iter3);
    }
 

Constructor Summary

DuplexIterator(java.util.Iterator iter1, java.util.Iterator iter2)
Constructs a DuplexIterator from two other Iterators.

Method Summary

boolean	hasNext() Returns true if there are more elements in either Iterator; otherwise false.
java.lang.Object	next() Returns the next element from the first Iterator; if the first Iterator has no more elements, then returns the next element from the second Iterator.
void	remove() Currently unsupported; always throws an UnsupportedOperationException.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DuplexIterator

public DuplexIterator(java.util.Iterator iter1,
                      java.util.Iterator iter2)

Constructs a DuplexIterator from two other Iterators.

Parameters:

iter1 - the first Iterator over which to iterate

iter2 - the second Iterator over which to iterate

Method Detail

hasNext

public boolean hasNext()

Returns true if there are more elements in either Iterator; otherwise false.

Specified by:

hasNext in interface java.util.Iterator

next

public java.lang.Object next()

Returns the next element from the first Iterator; if the first Iterator has no more elements, then returns the next element from the second Iterator.

Specified by:

next in interface java.util.Iterator

Throws:

java.util.NoSuchElementException - if there are no more elements in either Iterator

remove

public void remove()

Currently unsupported; always throws an UnsupportedOperationException.

Specified by:

remove in interface java.util.Iterator