com.gs.collections.impl.utility

Class LazyIterate

java.lang.Object

com.gs.collections.impl.utility.LazyIterate

public final class LazyIterate
extends java.lang.Object

LazyIterate is a factory class which creates "deferred" iterables around the specified iterables. A "deferred" iterable performs some operation, such as filtering or transforming, when the result iterable is iterated over. This makes the operation very memory efficient, because you don't have to create intermediate collections during the operation.

Since:

1.0

Method Summary

Methods

Modifier and Type	Method and Description
static <T> com.gs.collections.api.LazyIterable<T>	adapt(java.lang.Iterable<T> iterable) Creates a deferred rich iterable for the specified iterable
static <T> com.gs.collections.api.LazyIterable<com.gs.collections.api.RichIterable<T>>	chunk(java.lang.Iterable<T> iterable, int size)
static <T,V> com.gs.collections.api.LazyIterable<V>	collect(java.lang.Iterable<T> iterable, com.gs.collections.api.block.function.Function<? super T,? extends V> function) Creates a deferred transforming iterable for the specified iterable
static <T,V> com.gs.collections.api.LazyIterable<V>	collectIf(java.lang.Iterable<T> iterable, com.gs.collections.api.block.predicate.Predicate<? super T> predicate, com.gs.collections.api.block.function.Function<? super T,? extends V> function) Creates a deferred filtering and transforming iterable for the specified iterable
static <T> com.gs.collections.api.LazyIterable<T>	concatenate(java.lang.Iterable<T>... iterables) Combines iterables into a deferred composite iterable
static <T> com.gs.collections.api.LazyIterable<T>	drop(java.lang.Iterable<T> iterable, int count) Creates a deferred drop iterable for the specified iterable using the specified count as the size to drop
static <T> com.gs.collections.api.LazyIterable<T>	empty()
static <T,V> com.gs.collections.api.LazyIterable<V>	flatCollect(java.lang.Iterable<T> iterable, com.gs.collections.api.block.function.Function<? super T,? extends java.lang.Iterable<V>> function) Creates a deferred flattening iterable for the specified iterable
static <T> com.gs.collections.api.LazyIterable<T>	reject(java.lang.Iterable<T> iterable, com.gs.collections.api.block.predicate.Predicate<? super T> predicate) Creates a deferred negative filtering iterable for the specified iterable
static <T> com.gs.collections.api.LazyIterable<T>	select(java.lang.Iterable<T> iterable, com.gs.collections.api.block.predicate.Predicate<? super T> predicate) Creates a deferred filtering iterable for the specified iterable
static <T> com.gs.collections.api.LazyIterable<T>	selectInstancesOf(java.lang.Iterable<?> iterable, java.lang.Class<T> clazz)
static <T> com.gs.collections.api.LazyIterable<T>	take(java.lang.Iterable<T> iterable, int count) Creates a deferred take iterable for the specified iterable using the specified count as the limit
static <A,B> com.gs.collections.api.LazyIterable<com.gs.collections.api.tuple.Pair<A,B>>	zip(java.lang.Iterable<A> as, java.lang.Iterable<B> bs)
static <T> com.gs.collections.api.LazyIterable<com.gs.collections.api.tuple.Pair<T,java.lang.Integer>>	zipWithIndex(java.lang.Iterable<T> iterable)

Methods inherited from class java.lang.Object

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

Method Detail

adapt

public static <T> com.gs.collections.api.LazyIterable<T> adapt(java.lang.Iterable<T> iterable)

Creates a deferred rich iterable for the specified iterable

select

public static <T> com.gs.collections.api.LazyIterable<T> select(java.lang.Iterable<T> iterable,
                                                com.gs.collections.api.block.predicate.Predicate<? super T> predicate)

Creates a deferred filtering iterable for the specified iterable

reject

public static <T> com.gs.collections.api.LazyIterable<T> reject(java.lang.Iterable<T> iterable,
                                                com.gs.collections.api.block.predicate.Predicate<? super T> predicate)

Creates a deferred negative filtering iterable for the specified iterable

selectInstancesOf

public static <T> com.gs.collections.api.LazyIterable<T> selectInstancesOf(java.lang.Iterable<?> iterable,
                                                           java.lang.Class<T> clazz)

collect

public static <T,V> com.gs.collections.api.LazyIterable<V> collect(java.lang.Iterable<T> iterable,
                                                   com.gs.collections.api.block.function.Function<? super T,? extends V> function)

Creates a deferred transforming iterable for the specified iterable

flatCollect

public static <T,V> com.gs.collections.api.LazyIterable<V> flatCollect(java.lang.Iterable<T> iterable,
                                                       com.gs.collections.api.block.function.Function<? super T,? extends java.lang.Iterable<V>> function)

Creates a deferred flattening iterable for the specified iterable

collectIf

public static <T,V> com.gs.collections.api.LazyIterable<V> collectIf(java.lang.Iterable<T> iterable,
                                                     com.gs.collections.api.block.predicate.Predicate<? super T> predicate,
                                                     com.gs.collections.api.block.function.Function<? super T,? extends V> function)

Creates a deferred filtering and transforming iterable for the specified iterable

take

public static <T> com.gs.collections.api.LazyIterable<T> take(java.lang.Iterable<T> iterable,
                                              int count)

Creates a deferred take iterable for the specified iterable using the specified count as the limit

drop

public static <T> com.gs.collections.api.LazyIterable<T> drop(java.lang.Iterable<T> iterable,
                                              int count)

Creates a deferred drop iterable for the specified iterable using the specified count as the size to drop

concatenate

public static <T> com.gs.collections.api.LazyIterable<T> concatenate(java.lang.Iterable<T>... iterables)

Combines iterables into a deferred composite iterable

empty

public static <T> com.gs.collections.api.LazyIterable<T> empty()

zip

public static <A,B> com.gs.collections.api.LazyIterable<com.gs.collections.api.tuple.Pair<A,B>> zip(java.lang.Iterable<A> as,
                                                                                    java.lang.Iterable<B> bs)

zipWithIndex

public static <T> com.gs.collections.api.LazyIterable<com.gs.collections.api.tuple.Pair<T,java.lang.Integer>> zipWithIndex(java.lang.Iterable<T> iterable)

chunk

public static <T> com.gs.collections.api.LazyIterable<com.gs.collections.api.RichIterable<T>> chunk(java.lang.Iterable<T> iterable,
                                                                                    int size)