it.riccardotraverso.java.lang

Class MultiIterator<E>

java.lang.Object

it.riccardotraverso.java.lang.MultiIterator<E>

Type Parameters:

E - The type of the elements iterated through by each of the collected iterators. It is not mandatory that individual iterators are exactly of type Iterator<E>, they might be of any other type Iterator<E1> as long as E1 extends or implements E.

All Implemented Interfaces:

java.util.Iterator<E>

public class MultiIterator<E>
extends java.lang.Object
implements java.util.Iterator<E>

A MultiIterator collects a sequence of simple iterators in order to provide a convenient way to navigate through each of them. MultiIterator returns each element of each iterator, transparently moving to the next iterator as soon as the one currently used does not have any more elements.

Constructor Summary

Constructors

Constructor and Description
MultiIterator(java.lang.Iterable<? extends E>... its) Creates a new MultiIterator<E> by taking in a variable number of iterable objects, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .
MultiIterator(java.lang.Iterable<? extends E> i1, java.lang.Iterable<? extends E> i2) Creates a new MultiIterator<E> by taking in individual iterable elements in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .
MultiIterator(java.lang.Iterable<? extends E> i1, java.lang.Iterable<? extends E> i2, java.lang.Iterable<? extends E> i3) Creates a new MultiIterator<E> by taking in individual iterable elements in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .
MultiIterator(java.lang.Iterable<? extends E> i1, java.lang.Iterable<? extends E> i2, java.lang.Iterable<? extends E> i3, java.lang.Iterable<? extends E> i4) Creates a new MultiIterator<E> by taking in individual iterable elements in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .
MultiIterator(java.lang.Iterable<? extends E> i1, java.lang.Iterable<? extends E> i2, java.lang.Iterable<? extends E> i3, java.lang.Iterable<? extends E> i4, java.lang.Iterable<? extends E> i5) Creates a new MultiIterator<E> by taking in individual iterable elements in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .
MultiIterator(java.lang.Iterable<? extends E> i1, java.lang.Iterable<? extends E> i2, java.lang.Iterable<? extends E> i3, java.lang.Iterable<? extends E> i4, java.lang.Iterable<? extends E> i5, java.lang.Iterable<? extends E> i6) Creates a new MultiIterator<E> by taking in individual iterable elements in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .
MultiIterator(java.lang.Iterable<? extends E> i1, java.lang.Iterable<? extends E> i2, java.lang.Iterable<? extends E> i3, java.lang.Iterable<? extends E> i4, java.lang.Iterable<? extends E> i5, java.lang.Iterable<? extends E> i6, java.lang.Iterable<? extends E> i7) Creates a new MultiIterator<E> by taking in individual iterable elements in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .
MultiIterator(java.util.Iterator<? extends E>... its) Creates a new MultiIterator<E> by taking in a variable number of iterators, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E.
MultiIterator(java.util.Iterator<? extends E> i1, java.util.Iterator<? extends E> i2) Creates a new MultiIterator<E> by taking in individual iterators in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .
MultiIterator(java.util.Iterator<? extends E> i1, java.util.Iterator<? extends E> i2, java.util.Iterator<? extends E> i3) Creates a new MultiIterator<E> by taking in individual iterators in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .
MultiIterator(java.util.Iterator<? extends E> i1, java.util.Iterator<? extends E> i2, java.util.Iterator<? extends E> i3, java.util.Iterator<? extends E> i4) Creates a new MultiIterator<E> by taking in individual iterators in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .
MultiIterator(java.util.Iterator<? extends E> i1, java.util.Iterator<? extends E> i2, java.util.Iterator<? extends E> i3, java.util.Iterator<? extends E> i4, java.util.Iterator<? extends E> i5) Creates a new MultiIterator<E> by taking in individual iterators in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .
MultiIterator(java.util.Iterator<? extends E> i1, java.util.Iterator<? extends E> i2, java.util.Iterator<? extends E> i3, java.util.Iterator<? extends E> i4, java.util.Iterator<? extends E> i5, java.util.Iterator<? extends E> i6) Creates a new MultiIterator<E> by taking in individual iterators in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .
MultiIterator(java.util.Iterator<? extends E> i1, java.util.Iterator<? extends E> i2, java.util.Iterator<? extends E> i3, java.util.Iterator<? extends E> i4, java.util.Iterator<? extends E> i5, java.util.Iterator<? extends E> i6, java.util.Iterator<? extends E> i7) Creates a new MultiIterator<E> by taking in individual iterators in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .

Method Summary

Methods

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

Methods inherited from class java.lang.Object

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

Constructor Detail

MultiIterator

public MultiIterator(java.util.Iterator<? extends E>... its)

Creates a new MultiIterator<E> by taking in a variable number of iterators, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E.

NOTE: Invoking this constructor will cause a type safety warning, due to the use of generics with varargs. The warning can be safely suppressed by adding the annotation @SuppressWarnings("unchecked") at the call site.

Parameters:

its - The iterators, each with its own type Iterator<? extends E>.

MultiIterator

public MultiIterator(java.util.Iterator<? extends E> i1,
             java.util.Iterator<? extends E> i2)

Creates a new MultiIterator<E> by taking in individual iterators in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .

Parameters:

i1 - The first iterator

i2 - The second iterator

MultiIterator

public MultiIterator(java.util.Iterator<? extends E> i1,
             java.util.Iterator<? extends E> i2,
             java.util.Iterator<? extends E> i3)

Creates a new MultiIterator<E> by taking in individual iterators in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .

Parameters:

i1 - The first iterator

i2 - The second iterator

i3 - The third iterator

MultiIterator

public MultiIterator(java.util.Iterator<? extends E> i1,
             java.util.Iterator<? extends E> i2,
             java.util.Iterator<? extends E> i3,
             java.util.Iterator<? extends E> i4)

Creates a new MultiIterator<E> by taking in individual iterators in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .

Parameters:

i1 - The first iterator

i2 - The second iterator

i3 - The third iterator

i4 - The fourth iterator

MultiIterator

public MultiIterator(java.util.Iterator<? extends E> i1,
             java.util.Iterator<? extends E> i2,
             java.util.Iterator<? extends E> i3,
             java.util.Iterator<? extends E> i4,
             java.util.Iterator<? extends E> i5)

Creates a new MultiIterator<E> by taking in individual iterators in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .

Parameters:

i1 - The first iterator

i2 - The second iterator

i3 - The third iterator

i4 - The fourth iterator

i5 - The fifth iterator

MultiIterator

public MultiIterator(java.util.Iterator<? extends E> i1,
             java.util.Iterator<? extends E> i2,
             java.util.Iterator<? extends E> i3,
             java.util.Iterator<? extends E> i4,
             java.util.Iterator<? extends E> i5,
             java.util.Iterator<? extends E> i6)

Creates a new MultiIterator<E> by taking in individual iterators in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .

Parameters:

i1 - The first iterator

i2 - The second iterator

i3 - The third iterator

i4 - The fourth iterator

i5 - The fifth iterator

i6 - The sixth iterator

MultiIterator

public MultiIterator(java.util.Iterator<? extends E> i1,
             java.util.Iterator<? extends E> i2,
             java.util.Iterator<? extends E> i3,
             java.util.Iterator<? extends E> i4,
             java.util.Iterator<? extends E> i5,
             java.util.Iterator<? extends E> i6,
             java.util.Iterator<? extends E> i7)

Creates a new MultiIterator<E> by taking in individual iterators in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .

Parameters:

i1 - The first iterator

i2 - The second iterator

i3 - The third iterator

i4 - The fourth iterator

i5 - The fifth iterator

i6 - The sixth iterator

i7 - The seventh iterator

MultiIterator

public MultiIterator(java.lang.Iterable<? extends E>... its)

Creates a new MultiIterator<E> by taking in a variable number of iterable objects, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .

NOTE: Invoking this constructor will cause a type safety warning, due to the use of generics with varargs. The warning can be safely suppressed by adding the annotation @SuppressWarnings("unchecked") at the call site.

Parameters:

its - The iterators, each with its own type Iterable<? extends E>.

MultiIterator

public MultiIterator(java.lang.Iterable<? extends E> i1,
             java.lang.Iterable<? extends E> i2)

Creates a new MultiIterator<E> by taking in individual iterable elements in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .

Parameters:

i1 - The first iterable

i2 - The second iterable

MultiIterator

public MultiIterator(java.lang.Iterable<? extends E> i1,
             java.lang.Iterable<? extends E> i2,
             java.lang.Iterable<? extends E> i3)

Creates a new MultiIterator<E> by taking in individual iterable elements in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .

Parameters:

i1 - The first iterable

i2 - The second iterable

i3 - The third iterable

MultiIterator

public MultiIterator(java.lang.Iterable<? extends E> i1,
             java.lang.Iterable<? extends E> i2,
             java.lang.Iterable<? extends E> i3,
             java.lang.Iterable<? extends E> i4)

Creates a new MultiIterator<E> by taking in individual iterable elements in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .

Parameters:

i1 - The first iterable

i2 - The second iterable

i3 - The third iterable

i4 - The fourth iterable

MultiIterator

public MultiIterator(java.lang.Iterable<? extends E> i1,
             java.lang.Iterable<? extends E> i2,
             java.lang.Iterable<? extends E> i3,
             java.lang.Iterable<? extends E> i4,
             java.lang.Iterable<? extends E> i5)

Creates a new MultiIterator<E> by taking in individual iterable elements in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .

Parameters:

i1 - The first iterable

i2 - The second iterable

i3 - The third iterable

i4 - The fourth iterable

i5 - The fifth iterable

MultiIterator

public MultiIterator(java.lang.Iterable<? extends E> i1,
             java.lang.Iterable<? extends E> i2,
             java.lang.Iterable<? extends E> i3,
             java.lang.Iterable<? extends E> i4,
             java.lang.Iterable<? extends E> i5,
             java.lang.Iterable<? extends E> i6)

Creates a new MultiIterator<E> by taking in individual iterable elements in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .

Parameters:

i1 - The first iterable

i2 - The second iterable

i3 - The third iterable

i4 - The fourth iterable

i5 - The fifth iterable

i6 - The sixth iterable

MultiIterator

public MultiIterator(java.lang.Iterable<? extends E> i1,
             java.lang.Iterable<? extends E> i2,
             java.lang.Iterable<? extends E> i3,
             java.lang.Iterable<? extends E> i4,
             java.lang.Iterable<? extends E> i5,
             java.lang.Iterable<? extends E> i6,
             java.lang.Iterable<? extends E> i7)

Creates a new MultiIterator<E> by taking in individual iterable elements in a sequence, such that each one is instantiated on a (possibly different) type parameter which is a subclass of E .

Parameters:

i1 - The first iterable

i2 - The second iterable

i3 - The third iterable

i4 - The fourth iterable

i5 - The fifth iterable

i6 - The sixth iterable

i7 - The seventh iterable

Method Detail

hasNext

public boolean hasNext()

Specified by:

hasNext in interface java.util.Iterator<E>

next

public E next()

Specified by:

next in interface java.util.Iterator<E>

remove

public void remove()

Specified by:

remove in interface java.util.Iterator<E>