de.unkrig.commons.util.collections

Class IteratorUtil

java.lang.Object

de.unkrig.commons.util.collections.IteratorUtil

public final class IteratorUtil
extends java.lang.Object

Various Iterator-related utility methods.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	IteratorUtil.ArrayIterator<T> An Iterator that has a notion of an "array index", which is the index of the "next" element in an array.

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.Iterator	AT_END An iterator which is at its end.

Method Summary

Modifier and Type	Method and Description
static <T> java.util.Iterator<T>	atEnd()
static <T> java.util.Iterator<T>	filter(java.util.Iterator<? extends T> delegate, Predicate<? super T> qualifies) Returns an iterator which skips the elements of the delegate which do not qualifiy.
static <T> IteratorUtil.ArrayIterator<T>	iterator(T[] array)
static <T> java.util.Iterator<T>	repeat(int n, T value)
static <T> java.util.Iterator<T>	repeat(T value)
static <I,O> java.util.Iterator<O>	transform(java.util.Iterator<? extends I> delegate, Transformer<? super I,? extends O> transform) Returns an iterator which iterates the transformed elements of the delegate

Methods inherited from class java.lang.Object

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

Field Detail

AT_END

public static final java.util.Iterator AT_END

An iterator which is at its end.

To get the non-rawe type, use atEnd().

Method Detail

atEnd

public static <T> java.util.Iterator<T> atEnd()

Returns:

An Iterator which is always at its end

filter

public static <T> java.util.Iterator<T> filter(java.util.Iterator<? extends T> delegate,
                                               Predicate<? super T> qualifies)

Returns an iterator which skips the elements of the delegate which do not qualifiy.

transform

public static <I,O> java.util.Iterator<O> transform(java.util.Iterator<? extends I> delegate,
                                                    Transformer<? super I,? extends O> transform)

Returns an iterator which iterates the transformed elements of the delegate

repeat

public static <T> java.util.Iterator<T> repeat(T value)

Returns:

An iterator that produces an infinite sequence of value elements

repeat

public static <T> java.util.Iterator<T> repeat(int n,
                                               T value)

Returns:

An iterator that produces a sequence of n value elements

iterator

public static <T> IteratorUtil.ArrayIterator<T> iterator(T[] array)

Returns:

An iterator over the elements of the array