at.molindo.utils.collections

Class IteratorUtils

java.lang.Object

at.molindo.utils.collections.IteratorUtils

public class IteratorUtils
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.Iterable<?>	EMPTY_ITERABLE
static java.util.Iterator<?>	EMPTY_ITERATOR

Method Summary

Methods

Modifier and Type	Method and Description
static <T,C extends java.util.Collection<T>> C	addAll(C collection, java.util.Iterator<T> iter) adds all elements from iter to collection
static <T> java.lang.Iterable<T>	cast(java.lang.Class<T> cls, java.lang.Iterable<?> iterable) a type safe cast for Iterable
static <T> java.lang.Iterable<T>	cast(java.lang.Class<T> cls, java.lang.Object[] list) type safe cast from any array to an Iterable
static <T> java.util.Iterator<T>	chain(java.lang.Iterable<java.util.Iterator<? extends T>> iterable)
static <T> java.util.Iterator<T>	chain(java.util.Iterator<? extends T>... iterators)
static <T> java.util.Iterator<T>	chain(java.util.Iterator<java.util.Iterator<? extends T>> iter)
static <T> java.util.Iterator<T>	empty() type save access to EMPTY_ITERATOR
static <T> java.util.Iterator<T>	empty(java.lang.Class<T> cls)
static <T> java.lang.Iterable<T>	emptyIterable() type save access to EMPTY_ITERABLE
static <T> java.lang.Iterable<T>	emptyIterable(java.lang.Class<T> cls)
static boolean	equals(java.lang.Iterable<?> iterable1, java.lang.Iterable<?> iterable2)
static boolean	equals(java.util.Iterator<?> iter1, java.util.Iterator<?> iter2)
static <T> java.lang.Iterable<T>	filter(java.lang.Iterable<T> iterable, Function<T,java.lang.Boolean> filter)
static <T> java.util.Iterator<T>	filter(java.util.Iterator<T> iter, Function<T,java.lang.Boolean> filter)
static <T> T	first(java.lang.Iterable<T> iter)
static <T> java.lang.Iterable<T>	iterable(java.util.Iterator<T> iter)
static <T> java.util.Iterator<T>	iterator(java.lang.Iterable<T> iterable)
static <T> java.lang.Iterable<java.util.Iterator<T>>	iterators(java.lang.Iterable<? extends java.lang.Iterable<T>> iterables) transforms an Iterable of Iterables to an Iterable of Iterators
static <T> java.util.Iterator<java.util.Iterator<T>>	iterators(java.util.Iterator<? extends java.lang.Iterable<T>> iterables) transforms an Iterator of Iterables to an Iterator of Iterators
static <T> java.util.ArrayList<T>	list(java.lang.Iterable<T> iter)
static <T> java.util.ArrayList<T>	list(java.lang.Iterable<T> iter, int initialCapacity)
static <T> java.util.ArrayList<T>	list(java.util.Iterator<T> iter)
static <T> java.util.ArrayList<T>	list(java.util.Iterator<T> iter, int initialCapacity)
static <T> java.util.Iterator<T>	max(java.util.Iterator<T> iter, int max) don't return more elements than given by max
static <T> T	next(java.util.Iterator<T> iter)
static <T> java.lang.Iterable<T>	notNull(java.lang.Iterable<T> iter)
static <T> java.util.Iterator<T>	notNull(java.util.Iterator<T> iter)
static <T> java.util.Iterator<T>	object(T o)
static <K,V,M extends java.util.Map<K,V>> M	putKeys(M map, java.util.Iterator<K> iter, Function<K,V> func) adds all elements from iter to map, generating values using function
static <K,V,M extends java.util.Map<K,V>> M	putValues(M map, java.util.Iterator<V> iter, Function<V,K> func) adds all elements from iter to map, generating keys using function
static <T> java.lang.Iterable<T>	readOnly(java.lang.Iterable<T> iter)
static <T> java.util.Iterator<T>	readOnly(java.util.Iterator<T> iter)
static <T> java.util.Iterator<T>	skip(java.util.Iterator<T> iter, int skip) skips a given number of elements in iterator while there are available
static <F,T> java.lang.Iterable<T>	transform(java.lang.Iterable<? extends F> iterable, Function<F,T> f)
static <F,T> java.util.Iterator<T>	transform(java.util.Iterator<? extends F> iter, Function<F,T> f)

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY_ITERATOR

public static final java.util.Iterator<?> EMPTY_ITERATOR

EMPTY_ITERABLE

public static final java.lang.Iterable<?> EMPTY_ITERABLE

Method Detail

iterable

public static <T> java.lang.Iterable<T> iterable(java.util.Iterator<T> iter)

Type Parameters:

T -

Parameters:

iter -

Returns:

an Iterable that alway returns the passed Iterator instance

iterator

public static <T> java.util.Iterator<T> iterator(java.lang.Iterable<T> iterable)

Type Parameters:

T -

Parameters:

iterable -

Returns:

Iterable.iterator() or EMPTY_ITERATOR if null

iterators

public static <T> java.util.Iterator<java.util.Iterator<T>> iterators(java.util.Iterator<? extends java.lang.Iterable<T>> iterables)

transforms an Iterator of Iterables to an Iterator of Iterators

iterators

public static <T> java.lang.Iterable<java.util.Iterator<T>> iterators(java.lang.Iterable<? extends java.lang.Iterable<T>> iterables)

transforms an Iterable of Iterables to an Iterable of Iterators

next

public static <T> T next(java.util.Iterator<T> iter)

Type Parameters:

T -

Parameters:

iter -

Returns:

the next element if available, null otherwise

first

public static <T> T first(java.lang.Iterable<T> iter)

Type Parameters:

T -

Parameters:

iter -

Returns:

the first element if available, null otherwise

list

public static <T> java.util.ArrayList<T> list(java.lang.Iterable<T> iter)

Type Parameters:

T -

Parameters:

iter -

Returns:

an ArrayList containing all elements

list

public static <T> java.util.ArrayList<T> list(java.lang.Iterable<T> iter,
                              int initialCapacity)

Type Parameters:

T -

Parameters:

iter -

Returns:

an ArrayList containing all elements

list

public static <T> java.util.ArrayList<T> list(java.util.Iterator<T> iter)

Type Parameters:

T -

Parameters:

iter -

Returns:

an ArrayList containing all elements

list

public static <T> java.util.ArrayList<T> list(java.util.Iterator<T> iter,
                              int initialCapacity)

Type Parameters:

T -

Parameters:

iter -

Returns:

an ArrayList containing all elements

addAll

public static <T,C extends java.util.Collection<T>> C addAll(C collection,
                                             java.util.Iterator<T> iter)

adds all elements from iter to collection

Type Parameters:

T -

C -

Parameters:

collection -

iter -

Returns:

putKeys

public static <K,V,M extends java.util.Map<K,V>> M putKeys(M map,
                                           java.util.Iterator<K> iter,
                                           Function<K,V> func)

adds all elements from iter to map, generating values using function

Type Parameters:

K -

V -

M -

Parameters:

map -

iter -

func -

Returns:

putValues

public static <K,V,M extends java.util.Map<K,V>> M putValues(M map,
                                             java.util.Iterator<V> iter,
                                             Function<V,K> func)

adds all elements from iter to map, generating keys using function

Type Parameters:

K -

V -

M -

Parameters:

map -

iter -

func -

Returns:

empty

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

type save access to EMPTY_ITERATOR

Type Parameters:

T -

Returns:

empty

public static <T> java.util.Iterator<T> empty(java.lang.Class<T> cls)

emptyIterable

public static <T> java.lang.Iterable<T> emptyIterable()

type save access to EMPTY_ITERABLE

Type Parameters:

T -

Returns:

emptyIterable

public static <T> java.lang.Iterable<T> emptyIterable(java.lang.Class<T> cls)

notNull

public static <T> java.util.Iterator<T> notNull(java.util.Iterator<T> iter)

notNull

public static <T> java.lang.Iterable<T> notNull(java.lang.Iterable<T> iter)

cast

public static <T> java.lang.Iterable<T> cast(java.lang.Class<T> cls,
                             java.lang.Object[] list)

type safe cast from any array to an Iterable

Type Parameters:

T -

Parameters:

cls -

list -

Returns:

cast

public static <T> java.lang.Iterable<T> cast(java.lang.Class<T> cls,
                             java.lang.Iterable<?> iterable)

a type safe cast for Iterable

Type Parameters:

T -

Parameters:

cls -

iterable -

Returns:

skip

public static <T> java.util.Iterator<T> skip(java.util.Iterator<T> iter,
                             int skip)

skips a given number of elements in iterator while there are available

Type Parameters:

T -

Parameters:

iter -

skip -

Returns:

max

public static <T> java.util.Iterator<T> max(java.util.Iterator<T> iter,
                            int max)

don't return more elements than given by max

Type Parameters:

T -

Parameters:

iter -

max -

Returns:

object

public static <T> java.util.Iterator<T> object(T o)

filter

public static <T> java.lang.Iterable<T> filter(java.lang.Iterable<T> iterable,
                               Function<T,java.lang.Boolean> filter)

filter

public static <T> java.util.Iterator<T> filter(java.util.Iterator<T> iter,
                               Function<T,java.lang.Boolean> filter)

Type Parameters:

T -

Parameters:

iter -

filter - function that returns true if object is allowed

Returns:

transform

public static <F,T> java.util.Iterator<T> transform(java.util.Iterator<? extends F> iter,
                                    Function<F,T> f)

transform

public static <F,T> java.lang.Iterable<T> transform(java.lang.Iterable<? extends F> iterable,
                                    Function<F,T> f)

equals

public static boolean equals(java.lang.Iterable<?> iterable1,
             java.lang.Iterable<?> iterable2)

equals

public static boolean equals(java.util.Iterator<?> iter1,
             java.util.Iterator<?> iter2)

readOnly

public static <T> java.lang.Iterable<T> readOnly(@Nonnull
                                 java.lang.Iterable<T> iter)

readOnly

public static <T> java.util.Iterator<T> readOnly(@Nonnull
                                 java.util.Iterator<T> iter)

chain

public static <T> java.util.Iterator<T> chain(java.util.Iterator<? extends T>... iterators)

chain

public static <T> java.util.Iterator<T> chain(java.lang.Iterable<java.util.Iterator<? extends T>> iterable)

chain

public static <T> java.util.Iterator<T> chain(java.util.Iterator<java.util.Iterator<? extends T>> iter)