com.chemaxon.calculations.io

Interface CloseableIterator<T>

Type Parameters:

T - iterated type

All Superinterfaces:

java.lang.AutoCloseable, java.io.Closeable, java.util.Iterator<T>

All Known Implementing Classes:

com.chemaxon.calculations.io.CloseableAbstractIterator, MemoizingIterator, SmilesMemoizingMoleculeIterator

@Beta
 @PublicAPI
public interface CloseableIterator<T>
extends java.util.Iterator<T>, java.io.Closeable

Closeable iterator. The iterator requires explicit closing, reaching the last element should not result in implicit close. IOException potentially thrown from a delegate Closeable.close() is expected to be wrapped in to an IllegalStateException.

For providing an implementation one can use CloseableIterators.wrap(java.util.Iterator), CloseableIterators.wrap(java.util.Iterator, java.io.Closeable) or .

Please note that this interface 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
default void	close()
default <U> CloseableIterator<U>	transform(java.util.function.Function<T,U> transformation) Apply a transformation of the elements of this Iterator.

Methods inherited from interface java.util.Iterator

forEachRemaining, hasNext, next, remove

Method Detail

close

default void close()
            throws java.lang.IllegalStateException

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

Throws:

java.lang.IllegalStateException

transform

default <U> CloseableIterator<U> transform(java.util.function.Function<T,U> transformation)

Apply a transformation of the elements of this Iterator.

Type Parameters:

U - Transformed type

Parameters:

transformation - Transformation to apply on returned elements

Returns:

Transformed view of this Iterator