net.markenwerk.commons.iterators

Class InfixedIterator<Payload>

java.lang.Object

net.markenwerk.commons.iterators.InfixedIterator<Payload>

Type Parameters:

Payload - The payload type.

All Implemented Interfaces:

Iterator<Payload>

public final class InfixedIterator<Payload>
extends Object
implements Iterator<Payload>

An InfixedIterator is an Iterator that can be wrapped around a given Iterator and yields some given infix values between every value yielded by the given Iterator.

Calling IntegerArrayIterator.remove() calls Iterator.remove() removed on the wrapped Iterator, if, and only iff, the last call to IntegerArrayIterator.next() didn't return an infix value.

Since:

1.1.6

Author:

Torsten Krause (tk at markenwerk dot net)

Constructor Summary

Constructors

Constructor and Description
InfixedIterator(Iterator<? extends Payload> iterator, Payload... infixes) Creates a new InfixedIterator from the given Iterator and the given infix values.

Method Summary

Modifier and Type	Method and Description
boolean	hasNext()
Payload	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 Detail

InfixedIterator

public InfixedIterator(Iterator<? extends Payload> iterator,
                       Payload... infixes)
                throws IllegalArgumentException

Creates a new InfixedIterator from the given Iterator and the given infix values.

Parameters:

iterator - The Iterator, around which the new NullFreeIterator will be wrapped.

infixes - The infixes to be yielded.

Throws:

IllegalArgumentException - If the given Iterator is null.

Method Detail

hasNext

public boolean hasNext()

Specified by:

hasNext in interface Iterator<Payload>

next

public Payload next()
             throws NoSuchElementException

Specified by:

next in interface Iterator<Payload>

Throws:

NoSuchElementException

remove

public void remove()
            throws IllegalStateException

Specified by:

remove in interface Iterator<Payload>

Throws:

IllegalStateException