Package net.cscott.jutil

Class CombineIterator<E>

java.lang.Object

net.cscott.jutil.CombineIterator<E>

All Implemented Interfaces:

Iterator<E>

public class CombineIterator<E>
extends Object
implements Iterator<E>

A CombineIterator combines several different Iterators into one. Its remove() removes the last element returned from the Iterator it came from. A Stream of streams does the same, with Stream.flatMap(java.util.function.Function<? super T, ? extends java.util.stream.Stream<? extends R>>).

Author:

C. Scott Ananian <cananian@alumni.princeton.edu>

Constructor Summary

Constructors

Constructor	Description
CombineIterator(Iterator<? extends E> i1, Iterator<? extends E> i2)	Creates a CombineIterator from a pair of Iterators.
CombineIterator(Iterator<? extends E> i1, Iterator<? extends E> i2, Iterator<? extends E> i3)	Creates a CombineIterator from three Iterators.
CombineIterator(Iterator<? extends Iterator<? extends E>> it)	Creates a CombineIterator from an Iterator over Iterators.
CombineIterator(List<? extends Iterator<? extends E>> itl)	Creates a CombineIterator from a list of Iterators.

Method Summary

Modifier and Type	Method	Description
boolean	hasNext()
E	next()
void	remove()

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 Details

CombineIterator

public CombineIterator(List<? extends Iterator<? extends E>> itl)

Creates a CombineIterator from a list of Iterators.

CombineIterator

public CombineIterator(Iterator<? extends E> i1,
 Iterator<? extends E> i2)

Creates a CombineIterator from a pair of Iterators.

CombineIterator

public CombineIterator(Iterator<? extends E> i1,
 Iterator<? extends E> i2,
 Iterator<? extends E> i3)

Creates a CombineIterator from three Iterators.

CombineIterator

public CombineIterator(Iterator<? extends Iterator<? extends E>> it)

Creates a CombineIterator from an Iterator over Iterators.

Method Details

next

public E next()

Specified by:

next in interface Iterator<E>

hasNext

public boolean hasNext()

Specified by:

hasNext in interface Iterator<E>

remove

public void remove()

Specified by:

remove in interface Iterator<E>