oracle.ide.util

Class DuplexIterator<T>

java.lang.Object

oracle.ide.util.DuplexIterator<T>

All Implemented Interfaces:

java.util.Iterator<T>

public class DuplexIterator<T>
extends java.lang.Object
implements java.util.Iterator<T>

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

Constructors

Constructor and Description
DuplexIterator(java.util.Iterator<T> iter1, java.util.Iterator<T> iter2) Constructs a DuplexIterator from two other Iterators.

Method Summary

Modifier and Type	Method and Description
boolean	hasNext() Returns true if there are more elements in either Iterator; otherwise false.
T	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

Methods inherited from interface java.util.Iterator

forEachRemaining

Constructor Detail

DuplexIterator

public DuplexIterator(java.util.Iterator<T> iter1,
                      java.util.Iterator<T> 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<T>

next

public T 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<T>

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<T>