com.chemaxon.calculations.io

Class CloseableIterators

java.lang.Object

com.chemaxon.calculations.io.CloseableIterators

@Beta
 @PublicAPI
public final class CloseableIterators
extends java.lang.Object

Utility class.

Please note that this class is marked with @Beta annotation, so it can be subject of incompatible changes or removal in later releases.

Author:

Gabor Imre

Method Summary

Modifier and Type	Method and Description
static <T,U> CloseableIterator<U>	transform(CloseableIterator<T> i, java.util.function.Function<T,U> transformation) Deprecated. CloseableIterator.transform(java.util.function.Function) provides default method making this utility not necessary
static <T> CloseableIterator<T>	wrap(java.util.Iterator<T> i) Wrap an Iterator into a CloseableIterator.
static <T> CloseableIterator<T>	wrap(java.util.Iterator<T> i, java.io.Closeable c) Compose an Iterator and a Closeable into a CloseableIterator.
static <S extends java.io.Closeable,T> CloseableIterator<T>	wrapTransformed(S source, java.util.function.Function<? super S,java.util.Iterator<T>> transformation) Make a CloseableIterator from an Iterator resulting from the transformation of a Closeable.

Methods inherited from class java.lang.Object

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

Method Detail

wrapTransformed

public static <S extends java.io.Closeable,T> CloseableIterator<T> wrapTransformed(S source,
                                                                                   java.util.function.Function<? super S,java.util.Iterator<T>> transformation)

Make a CloseableIterator from an Iterator resulting from the transformation of a Closeable.

Type Parameters:

S - Type of source which is Closeable and will be transformed into an Iterator

T - Type of iterated item created by the transformed Iterator

Parameters:

source - Source to transform and to close

transformation - Transformation

Returns:

Result

transform

@Deprecated
public static <T,U> CloseableIterator<U> transform(CloseableIterator<T> i,
                                                               java.util.function.Function<T,U> transformation)

Deprecated. CloseableIterator.transform(java.util.function.Function) provides default method making this utility not necessary

Create a transformed view of a CloseableIterator. The returned instances enforce CloseableIterator.close() related API contracts.

Type Parameters:

T - Iterated type

U - Transformed type

Parameters:

i - Iterator to wrap

transformation - Transformation to apply

Returns:

Transformed view

wrap

public static <T> CloseableIterator<T> wrap(java.util.Iterator<T> i)

Wrap an Iterator into a CloseableIterator. The returned instances enforce CloseableIterator.close() related API contracts.

Type Parameters:

T - Iterated type

Parameters:

i - Iterator to wrap

Returns:

Wrapped instance

wrap

public static <T> CloseableIterator<T> wrap(java.util.Iterator<T> i,
                                            java.io.Closeable c)

Compose an Iterator and a Closeable into a CloseableIterator.

Type Parameters:

T - Iterated type

Parameters:

i - Iterator to wrap

c - Closeable to delegate

Returns:

Composite