com.technia.tvc.core.util

Class IteratorUtils2

java.lang.Object

com.technia.tvc.core.util.IteratorUtils2

public class IteratorUtils2
extends java.lang.Object

This class implements a few utility methods in addition to those found in IteratorUtils.

Since:

5.2.1

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	IteratorUtils2.Zipper<L,R,O> Zips two input into another

Constructor Summary

Constructors

Constructor and Description
IteratorUtils2()

Method Summary

Modifier and Type	Method and Description
static <T> java.util.Iterator<T>	chainedIterator(java.util.Iterator<T>... iterators) Converts array of iterators to chained iterator
static int	countElements(java.util.Iterator<?> itr) Returns the number of elements in the java.util.Iterator.
static <T> java.util.Iterator<T>	emptyIterator()
static <E> E	getElement(java.util.Iterator<E> itr, int index)
static <E> java.util.Iterator<E>	rangeIterator(java.util.Iterator<E> itr, int off, int len)
static <T> T[]	toArray(java.util.Iterator<? extends T> iterator, java.lang.Class<T> arrayClass) Added this method as the similar method from "commons/collections15" did not allow the iterator to hold items that is a subclass from the generic type.
static <T> java.lang.Iterable<T>	toIterable(java.util.Iterator<T> itr) Converts iterator to Iterable
static <T> java.util.List<T>	toList(java.util.Iterator<T> itr) Converts iterator to List
static <L,R,O> java.util.Iterator<O>	zippedIterator(java.util.Iterator<L> left, java.util.Iterator<R> right, IteratorUtils2.Zipper<L,R,O> zipper) Converts two iterators to zipped iterator

Methods inherited from class java.lang.Object

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

Constructor Detail

IteratorUtils2

public IteratorUtils2()

Method Detail

countElements

public static int countElements(java.util.Iterator<?> itr)

Returns the number of elements in the java.util.Iterator.

Parameters:

itr - the java.util.Iterator to count.

rangeIterator

public static <E> java.util.Iterator<E> rangeIterator(java.util.Iterator<E> itr,
                                                      int off,
                                                      int len)

getElement

public static <E> E getElement(java.util.Iterator<E> itr,
                               int index)

emptyIterator

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

toArray

public static <T> T[] toArray(java.util.Iterator<? extends T> iterator,
                              java.lang.Class<T> arrayClass)

Added this method as the similar method from "commons/collections15" did not allow the iterator to hold items that is a subclass from the generic type.

Parameters:

iterator - The iterator of items

arrayClass - The array class type.

Returns:

An array holding all items from the iterator

Since:

2010.1.0

toList

public static <T> java.util.List<T> toList(java.util.Iterator<T> itr)

Converts iterator to List

Parameters:

itr - The Iterator to be converted.

Returns:

list

Since:

2015.2.0

toIterable

public static <T> java.lang.Iterable<T> toIterable(java.util.Iterator<T> itr)

Converts iterator to Iterable

Parameters:

itr - The Iterator to be converted.

Returns:

iterable

Since:

2017.2.0

chainedIterator

@SafeVarargs
public static <T> java.util.Iterator<T> chainedIterator(java.util.Iterator<T>... iterators)

Converts array of iterators to chained iterator

Parameters:

iterators - The Iterators to be chained.

Returns:

chained iterator

Since:

2017.2.0

zippedIterator

public static <L,R,O> java.util.Iterator<O> zippedIterator(java.util.Iterator<L> left,
                                                           java.util.Iterator<R> right,
                                                           IteratorUtils2.Zipper<L,R,O> zipper)

Converts two iterators to zipped iterator

Parameters:

left - The Iterators to be zipped.

right - The Iterators to be zipped.

zipper - The Zipper

Returns:

zipped iterator

Since:

2017.2.0