Package org.eclipse.collections.impl.lazy

Class AbstractLazyIterable<T>

java.lang.Object

org.eclipse.collections.impl.AbstractRichIterable<T>

org.eclipse.collections.impl.lazy.AbstractLazyIterable<T>

All Implemented Interfaces:

Iterable<T>, InternalIterable<T>, LazyIterable<T>, RichIterable<T>

Direct Known Subclasses:

ChunkBooleanIterable, ChunkByteIterable, ChunkCharIterable, ChunkDoubleIterable, ChunkFloatIterable, ChunkIntIterable, ChunkIterable, ChunkLongIterable, ChunkShortIterable, CollectBooleanToObjectIterable, CollectByteToObjectIterable, CollectCharToObjectIterable, CollectDoubleToObjectIterable, CollectFloatToObjectIterable, CollectIntToObjectIterable, CollectIterable, CollectLongToObjectIterable, CollectShortToObjectIterable, CompositeIterable, DistinctIterable, DropIterable, DropWhileIterable, FlatCollectBooleanToObjectIterable, FlatCollectByteToObjectIterable, FlatCollectCharToObjectIterable, FlatCollectDoubleToObjectIterable, FlatCollectFloatToObjectIterable, FlatCollectIntToObjectIterable, FlatCollectIterable, FlatCollectLongToObjectIterable, FlatCollectShortToObjectIterable, Interval, LazyIterableAdapter, RejectIterable, ReverseIterable, SelectInstancesOfIterable, SelectIterable, TakeIterable, TakeWhileIterable, TapIterable, ZipIterable, ZipWithIndexIterable

public abstract class AbstractLazyIterable<T>
extends AbstractRichIterable<T>
implements LazyIterable<T>

AbstractLazyIterable provides a base from which deferred iterables such as SelectIterable, RejectIterable and CollectIterable can be derived.

Constructor Summary

Constructors

Constructor	Description
AbstractLazyIterable()

Method Summary

Modifier and Type	Method	Description
LazyIterable<T>	asLazy()	Returns a lazy (deferred) iterable, most likely implemented by calling LazyIterate.adapt(this).
LazyIterable<RichIterable<T>>	chunk(int size)	Creates a deferred chunk iterable.
<V> LazyIterable<V>	collect(Function<? super T,? extends V> function)	Creates a deferred iterable for collecting elements from the current iterable.
LazyBooleanIterable	collectBoolean(BooleanFunction<? super T> booleanFunction)	Returns a lazy BooleanIterable which will transform the underlying iterable data to boolean values based on the booleanFunction.
LazyByteIterable	collectByte(ByteFunction<? super T> byteFunction)	Returns a lazy ByteIterable which will transform the underlying iterable data to byte values based on the byteFunction.
LazyCharIterable	collectChar(CharFunction<? super T> charFunction)	Returns a lazy CharIterable which will transform the underlying iterable data to char values based on the charFunction.
LazyDoubleIterable	collectDouble(DoubleFunction<? super T> doubleFunction)	Returns a lazy DoubleIterable which will transform the underlying iterable data to double values based on the doubleFunction.
LazyFloatIterable	collectFloat(FloatFunction<? super T> floatFunction)	Returns a lazy FloatIterable which will transform the underlying iterable data to float values based on the floatFunction.
<V> LazyIterable<V>	collectIf(Predicate<? super T> predicate, Function<? super T,? extends V> function)	Creates a deferred iterable for selecting and collecting elements from the current iterable.
LazyIntIterable	collectInt(IntFunction<? super T> intFunction)	Returns a lazy IntIterable which will transform the underlying iterable data to int values based on the intFunction.
LazyLongIterable	collectLong(LongFunction<? super T> longFunction)	Returns a lazy LongIterable which will transform the underlying iterable data to long values based on the longFunction.
LazyShortIterable	collectShort(ShortFunction<? super T> shortFunction)	Returns a lazy ShortIterable which will transform the underlying iterable data to short values based on the shortFunction.
<P, V> LazyIterable<V>	collectWith(Function2<? super T,? super P,? extends V> function, P parameter)	Same as RichIterable.collect(Function) with a Function2 and specified parameter which is passed to the block.
LazyIterable<T>	concatenate(Iterable<T> iterable)	Creates a deferred iterable that will join this iterable with the specified iterable.
LazyIterable<T>	distinct()	Creates a deferred distinct iterable to get distinct elements from the current iterable.
LazyIterable<T>	drop(int count)	Creates a deferred drop iterable for the current iterable using the specified count as the limit.
LazyIterable<T>	dropWhile(Predicate<? super T> predicate)
<V> LazyIterable<V>	flatCollect(Function<? super T,? extends Iterable<V>> function)	Creates a deferred flattening iterable for the current iterable.
T	getFirst()	Returns the first element of an iterable.
T	getLast()	Returns the last element of an iterable.
T	getOnly()	Returns the element if the iterable has exactly one element.
<V> Multimap<V,T>	groupBy(Function<? super T,? extends V> function)	For each element of the iterable, the function is evaluated and the results of these evaluations are collected into a new multimap, where the transformed value is the key and the original values are added to the same (or similar) species of collection as the source iterable.
<V> Multimap<V,T>	groupByEach(Function<? super T,? extends Iterable<V>> function)	Similar to RichIterable.groupBy(Function), except the result of evaluating function will return a collection of keys for each value.
<V> MapIterable<V,T>	groupByUniqueKey(Function<? super T,? extends V> function)	For each element of the iterable, the function is evaluated, and the results of these evaluations are collected into a new map, where the transformed value is the key.
<R extends Collection<T>> R	into(R target)	Adds all the elements in this iterable to the specific target Collection.
boolean	isEmpty()	Returns true if this iterable has zero items.
<V extends Comparable<? super V>> Optional<T>	maxByOptional(Function<? super T,? extends V> function)	Returns the maximum elements out of this container based on the natural order of the attribute returned by Function as an Optional.
Optional<T>	maxOptional()	Returns the maximum element out of this container based on the natural order as an Optional.
Optional<T>	maxOptional(Comparator<? super T> comparator)	Returns the maximum element out of this container based on the comparator as an Optional.
<V extends Comparable<? super V>> Optional<T>	minByOptional(Function<? super T,? extends V> function)	Returns the minimum elements out of this container based on the natural order of the attribute returned by Function as an Optional.
Optional<T>	minOptional()	Returns the minimum element out of this container based on the natural order as an Optional.
Optional<T>	minOptional(Comparator<? super T> comparator)	Returns the minimum element out of this container based on the comparator as an Optional.
PartitionMutableList<T>	partition(Predicate<? super T> predicate)	Filters a collection into a PartitionedIterable based on the evaluation of the predicate.
<P> PartitionMutableList<T>	partitionWith(Predicate2<? super T,? super P> predicate, P parameter)	Filters a collection into a PartitionIterable based on the evaluation of the predicate.
LazyIterable<T>	reject(Predicate<? super T> predicate)	Creates a deferred iterable for rejecting elements from the current iterable.
<P> LazyIterable<T>	rejectWith(Predicate2<? super T,? super P> predicate, P parameter)	Similar to RichIterable.reject(Predicate), except with an evaluation parameter for the second generic argument in Predicate2.
LazyIterable<T>	select(Predicate<? super T> predicate)	Creates a deferred iterable for selecting elements from the current iterable.
<S> LazyIterable<S>	selectInstancesOf(Class<S> clazz)	Returns all elements of the source collection that are instances of the Class clazz.
<P> LazyIterable<T>	selectWith(Predicate2<? super T,? super P> predicate, P parameter)	Similar to RichIterable.select(Predicate), except with an evaluation parameter for the second generic argument in Predicate2.
int	size()	Returns the number of items in this iterable.
<V> ObjectDoubleMap<V>	sumByDouble(Function<? super T,? extends V> groupBy, DoubleFunction<? super T> function)	Groups and sums the values using the two specified functions.
<V> ObjectDoubleMap<V>	sumByFloat(Function<? super T,? extends V> groupBy, FloatFunction<? super T> function)	Groups and sums the values using the two specified functions.
<V> ObjectLongMap<V>	sumByInt(Function<? super T,? extends V> groupBy, IntFunction<? super T> function)	Groups and sums the values using the two specified functions.
<V> ObjectLongMap<V>	sumByLong(Function<? super T,? extends V> groupBy, LongFunction<? super T> function)	Groups and sums the values using the two specified functions.
LazyIterable<T>	take(int count)	Creates a deferred take iterable for the current iterable using the specified count as the limit.
LazyIterable<T>	takeWhile(Predicate<? super T> predicate)
LazyIterable<T>	tap(Procedure<? super T> procedure)	Creates a deferred tap iterable.
<E> E[]	toArray(E[] array)	Converts this iterable to an array using the specified target array, assuming the target array is as long or longer than the iterable.
MutableStack<T>	toStack()
<S> LazyIterable<Pair<T,S>>	zip(Iterable<S> that)	Creates a deferred zip iterable.
LazyIterable<Pair<T,Integer>>	zipWithIndex()	Creates a deferred zipWithIndex iterable.

Methods inherited from class org.eclipse.collections.impl.AbstractRichIterable

allSatisfy, allSatisfyWith, anySatisfy, anySatisfyWith, appendString, appendString, collect, collectIf, collectWith, contains, containsAll, containsAllArguments, containsAllIterable, count, countByEach, countWith, detect, detectOptional, detectWith, detectWithIfNone, detectWithOptional, flatCollect, forEach, forEachWith, forEachWithIndex, groupBy, groupByEach, groupByUniqueKey, injectInto, injectInto, injectInto, injectInto, injectInto, max, max, maxBy, min, min, minBy, noneSatisfy, noneSatisfyWith, reject, rejectWith, select, selectWith, sumOfDouble, sumOfFloat, sumOfInt, sumOfLong, toArray, toBag, toBiMap, toList, toMap, toSet, toSortedBag, toSortedBag, toSortedBagBy, toSortedListBy, toSortedMap, toSortedMap, toSortedMapBy, toSortedSet, toSortedSet, toSortedSetBy, toString, zip, zipWithIndex

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.eclipse.collections.api.InternalIterable

forEach, forEachWith, forEachWithIndex

Methods inherited from interface java.lang.Iterable

iterator, spliterator

Methods inherited from interface org.eclipse.collections.api.LazyIterable

flatCollectWith

Methods inherited from interface org.eclipse.collections.api.RichIterable

aggregateBy, aggregateBy, aggregateInPlaceBy, allSatisfy, allSatisfyWith, anySatisfy, anySatisfyWith, appendString, appendString, appendString, collect, collectBoolean, collectByte, collectChar, collectDouble, collectFloat, collectIf, collectInt, collectLong, collectShort, collectWith, contains, containsAll, containsAllArguments, containsAllIterable, containsAny, containsAnyIterable, containsBy, containsNone, containsNoneIterable, count, countBy, countBy, countByEach, countByEach, countByWith, countByWith, countWith, detect, detectIfNone, detectOptional, detectWith, detectWithIfNone, detectWithOptional, each, flatCollect, flatCollectBoolean, flatCollectByte, flatCollectChar, flatCollectDouble, flatCollectFloat, flatCollectInt, flatCollectLong, flatCollectShort, flatCollectWith, forEach, getAny, groupBy, groupByAndCollect, groupByEach, groupByUniqueKey, injectInto, injectInto, injectInto, injectInto, injectInto, injectIntoDouble, injectIntoFloat, injectIntoInt, injectIntoLong, makeString, makeString, makeString, makeString, max, max, maxBy, min, min, minBy, noneSatisfy, noneSatisfyWith, notEmpty, reduce, reduceInPlace, reduceInPlace, reject, rejectWith, select, selectWith, summarizeDouble, summarizeFloat, summarizeInt, summarizeLong, sumOfDouble, sumOfFloat, sumOfInt, sumOfLong, toArray, toBag, toBiMap, toImmutableBag, toImmutableBiMap, toImmutableList, toImmutableMap, toImmutableSet, toImmutableSortedBag, toImmutableSortedBag, toImmutableSortedBagBy, toImmutableSortedList, toImmutableSortedList, toImmutableSortedListBy, toImmutableSortedSet, toImmutableSortedSet, toImmutableSortedSetBy, toList, toMap, toMap, toSet, toSortedBag, toSortedBag, toSortedBagBy, toSortedList, toSortedList, toSortedListBy, toSortedMap, toSortedMap, toSortedMapBy, toSortedSet, toSortedSet, toSortedSetBy, toString, zip, zipWithIndex

Constructor Details

AbstractLazyIterable

public AbstractLazyIterable()

Method Details

asLazy

public LazyIterable<T> asLazy()

Description copied from interface: RichIterable

Returns a lazy (deferred) iterable, most likely implemented by calling LazyIterate.adapt(this).

Specified by:

asLazy in interface RichIterable<T>

Overrides:

asLazy in class AbstractRichIterable<T>

into

public <R extends Collection<T>> R into(R target)

Description copied from interface: RichIterable

Adds all the elements in this iterable to the specific target Collection.

Specified by:

into in interface LazyIterable<T>

Specified by:

into in interface RichIterable<T>

Overrides:

into in class AbstractRichIterable<T>

toArray

public <E> E[] toArray(E[] array)

Description copied from interface: RichIterable

Converts this iterable to an array using the specified target array, assuming the target array is as long or longer than the iterable.

Specified by:

toArray in interface RichIterable<T>

Overrides:

toArray in class AbstractRichIterable<T>

See Also:

• Collection.toArray(Object[])

size

public int size()

Description copied from interface: RichIterable

Returns the number of items in this iterable.

Specified by:

size in interface RichIterable<T>

isEmpty

public boolean isEmpty()

Description copied from interface: RichIterable

Returns true if this iterable has zero items.

Specified by:

isEmpty in interface RichIterable<T>

Overrides:

isEmpty in class AbstractRichIterable<T>

getFirst

public T getFirst()

Description copied from interface: RichIterable

Returns the first element of an iterable. In the case of a List it is the element at the first index. In the case of any other Collection, it is the first element that would be returned during an iteration. If the iterable is empty, null is returned. If null is a valid element of the container, then a developer would need to check to see if the iterable is empty to validate that a null result was not due to the container being empty.

The order of Sets are not guaranteed (except for TreeSets and other Ordered Set implementations), so if you use this method, the first element could be any element from the Set.

Specified by:

getFirst in interface LazyIterable<T>

Specified by:

getFirst in interface RichIterable<T>

getLast

public T getLast()

Description copied from interface: RichIterable

Returns the last element of an iterable. In the case of a List it is the element at the last index. In the case of any other Collection, it is the last element that would be returned during an iteration. If the iterable is empty, null is returned. If null is a valid element of the container, then a developer would need to check to see if the iterable is empty to validate that a null result was not due to the container being empty.

The order of Sets are not guaranteed (except for TreeSets and other Ordered Set implementations), so if you use this method, the last element could be any element from the Set.

Specified by:

getLast in interface RichIterable<T>

getOnly

public T getOnly()

Description copied from interface: RichIterable

Returns the element if the iterable has exactly one element. Otherwise, throw IllegalStateException.

Specified by:

getOnly in interface RichIterable<T>

Returns:

an element of an iterable.

select

public LazyIterable<T> select(Predicate<? super T> predicate)

Description copied from interface: LazyIterable

Creates a deferred iterable for selecting elements from the current iterable.

Specified by:

select in interface LazyIterable<T>

Specified by:

select in interface RichIterable<T>

selectWith

public <P> LazyIterable<T> selectWith(Predicate2<? super T,? super P> predicate,
 P parameter)

Description copied from interface: RichIterable

Similar to RichIterable.select(Predicate), except with an evaluation parameter for the second generic argument in Predicate2.

E.g. return a Collection of Person elements where the person has an age greater than or equal to 18 years

Example using a Java 8 lambda expression:

 RichIterable<Person> selected =
     people.selectWith((Person person, Integer age) -> person.getAge()>= age, Integer.valueOf(18));
 

Example using an anonymous inner class:

 RichIterable<Person> selected =
     people.selectWith(new Predicate2<Person, Integer>()
     {
         public boolean accept(Person person, Integer age)
         {
             return person.getAge()>= age;
         }
     }, Integer.valueOf(18));
 

Specified by:

selectWith in interface LazyIterable<T>

Specified by:

selectWith in interface RichIterable<T>

Parameters:

predicate - a Predicate2 to use as the select criteria

parameter - a parameter to pass in for evaluation of the second argument P in predicate

See Also:

• RichIterable.select(Predicate)

reject

public LazyIterable<T> reject(Predicate<? super T> predicate)

Description copied from interface: LazyIterable

Creates a deferred iterable for rejecting elements from the current iterable.

Specified by:

reject in interface LazyIterable<T>

Specified by:

reject in interface RichIterable<T>

Parameters:

predicate - a Predicate to use as the reject criteria

Returns:

a RichIterable that contains elements that cause Predicate.accept(Object) method to evaluate to false

rejectWith

public <P> LazyIterable<T> rejectWith(Predicate2<? super T,? super P> predicate,
 P parameter)

Description copied from interface: RichIterable

Similar to RichIterable.reject(Predicate), except with an evaluation parameter for the second generic argument in Predicate2.

E.g. return a Collection of Person elements where the person has an age greater than or equal to 18 years

Example using a Java 8 lambda expression:

 RichIterable<Person> rejected =
     people.rejectWith((Person person, Integer age) -> person.getAge() < age, Integer.valueOf(18));
 

Example using an anonymous inner class:

 MutableList<Person> rejected =
     people.rejectWith(new Predicate2<Person, Integer>()
     {
         public boolean accept(Person person, Integer age)
         {
             return person.getAge() < age;
         }
     }, Integer.valueOf(18));
 

Specified by:

rejectWith in interface LazyIterable<T>

Specified by:

rejectWith in interface RichIterable<T>

Parameters:

predicate - a Predicate2 to use as the select criteria

parameter - a parameter to pass in for evaluation of the second argument P in predicate

See Also:

• RichIterable.select(Predicate)

partition

public PartitionMutableList<T> partition(Predicate<? super T> predicate)

Description copied from interface: RichIterable

Filters a collection into a PartitionedIterable based on the evaluation of the predicate.

Example using a Java 8 lambda expression:

 PartitionIterable<Person> newYorkersAndNonNewYorkers =
     people.partition(person -> person.getAddress().getState().getName().equals("New York"));
 

Example using an anonymous inner class:

 PartitionIterable<Person> newYorkersAndNonNewYorkers =
     people.partition(new Predicate<Person>()
     {
         public boolean accept(Person person)
         {
             return person.getAddress().getState().getName().equals("New York");
         }
     });
 

Specified by:

partition in interface RichIterable<T>

partitionWith

public <P> PartitionMutableList<T> partitionWith(Predicate2<? super T,? super P> predicate,
 P parameter)

Description copied from interface: RichIterable

Filters a collection into a PartitionIterable based on the evaluation of the predicate.

Example using a Java 8 lambda expression:

 PartitionIterable<Person> newYorkersAndNonNewYorkers =
     people.partitionWith((Person person, String state) -> person.getAddress().getState().getName().equals(state), "New York");
 

Example using an anonymous inner class:

 PartitionIterable<Person> newYorkersAndNonNewYorkers =
     people.partitionWith(new Predicate2<Person, String>()
     {
         public boolean accept(Person person, String state)
         {
             return person.getAddress().getState().getName().equals(state);
         }
     }, "New York");
 

Specified by:

partitionWith in interface RichIterable<T>

selectInstancesOf

public <S> LazyIterable<S> selectInstancesOf(Class<S> clazz)

Description copied from interface: RichIterable

Returns all elements of the source collection that are instances of the Class clazz.

 RichIterable<Integer> integers =
     List.mutable.with(new Integer(0), new Long(0L), new Double(0.0)).selectInstancesOf(Integer.class);
 

Specified by:

selectInstancesOf in interface LazyIterable<T>

Specified by:

selectInstancesOf in interface RichIterable<T>

collect

public <V> LazyIterable<V> collect(Function<? super T,? extends V> function)

Description copied from interface: LazyIterable

Creates a deferred iterable for collecting elements from the current iterable.

Specified by:

collect in interface LazyIterable<T>

Specified by:

collect in interface RichIterable<T>

collectBoolean

public LazyBooleanIterable collectBoolean(BooleanFunction<? super T> booleanFunction)

Description copied from interface: LazyIterable

Returns a lazy BooleanIterable which will transform the underlying iterable data to boolean values based on the booleanFunction.

Specified by:

collectBoolean in interface LazyIterable<T>

Specified by:

collectBoolean in interface RichIterable<T>

collectByte

public LazyByteIterable collectByte(ByteFunction<? super T> byteFunction)

Description copied from interface: LazyIterable

Returns a lazy ByteIterable which will transform the underlying iterable data to byte values based on the byteFunction.

Specified by:

collectByte in interface LazyIterable<T>

Specified by:

collectByte in interface RichIterable<T>

collectChar

public LazyCharIterable collectChar(CharFunction<? super T> charFunction)

Description copied from interface: LazyIterable

Returns a lazy CharIterable which will transform the underlying iterable data to char values based on the charFunction.

Specified by:

collectChar in interface LazyIterable<T>

Specified by:

collectChar in interface RichIterable<T>

collectDouble

public LazyDoubleIterable collectDouble(DoubleFunction<? super T> doubleFunction)

Description copied from interface: LazyIterable

Returns a lazy DoubleIterable which will transform the underlying iterable data to double values based on the doubleFunction.

Specified by:

collectDouble in interface LazyIterable<T>

Specified by:

collectDouble in interface RichIterable<T>

collectFloat

public LazyFloatIterable collectFloat(FloatFunction<? super T> floatFunction)

Description copied from interface: LazyIterable

Returns a lazy FloatIterable which will transform the underlying iterable data to float values based on the floatFunction.

Specified by:

collectFloat in interface LazyIterable<T>

Specified by:

collectFloat in interface RichIterable<T>

collectInt

public LazyIntIterable collectInt(IntFunction<? super T> intFunction)

Description copied from interface: LazyIterable

Returns a lazy IntIterable which will transform the underlying iterable data to int values based on the intFunction.

Specified by:

collectInt in interface LazyIterable<T>

Specified by:

collectInt in interface RichIterable<T>

collectLong

public LazyLongIterable collectLong(LongFunction<? super T> longFunction)

Description copied from interface: LazyIterable

Returns a lazy LongIterable which will transform the underlying iterable data to long values based on the longFunction.

Specified by:

collectLong in interface LazyIterable<T>

Specified by:

collectLong in interface RichIterable<T>

collectShort

public LazyShortIterable collectShort(ShortFunction<? super T> shortFunction)

Description copied from interface: LazyIterable

Returns a lazy ShortIterable which will transform the underlying iterable data to short values based on the shortFunction.

Specified by:

collectShort in interface LazyIterable<T>

Specified by:

collectShort in interface RichIterable<T>

collectWith

public <P,
V> LazyIterable<V> collectWith(Function2<? super T,? super P,? extends V> function,
 P parameter)

Description copied from interface: RichIterable

Same as RichIterable.collect(Function) with a Function2 and specified parameter which is passed to the block.

Example using a Java 8 lambda expression:

 RichIterable<Integer> integers =
     Lists.mutable.with(1, 2, 3).collectWith((each, parameter) -> each + parameter, Integer.valueOf(1));
 

Example using an anonymous inner class:

 Function2<Integer, Integer, Integer> addParameterFunction =
     new Function2<Integer, Integer, Integer>()
     {
         public Integer value(Integer each, Integer parameter)
         {
             return each + parameter;
         }
     };
 RichIterable<Integer> integers =
     Lists.mutable.with(1, 2, 3).collectWith(addParameterFunction, Integer.valueOf(1));
 

Specified by:

collectWith in interface LazyIterable<T>

Specified by:

collectWith in interface RichIterable<T>

Parameters:

function - A Function2 to use as the collect transformation function

parameter - A parameter to pass in for evaluation of the second argument P in function

Returns:

A new RichIterable that contains the transformed elements returned by Function2.value(Object, Object)

See Also:

• RichIterable.collect(Function)

flatCollect

public <V> LazyIterable<V> flatCollect(Function<? super T,? extends Iterable<V>> function)

Description copied from interface: LazyIterable

Creates a deferred flattening iterable for the current iterable.

Specified by:

flatCollect in interface LazyIterable<T>

Specified by:

flatCollect in interface RichIterable<T>

Parameters:

function - The Function to apply

Returns:

a new flattened collection produced by applying the given function

concatenate

public LazyIterable<T> concatenate(Iterable<T> iterable)

Description copied from interface: LazyIterable

Creates a deferred iterable that will join this iterable with the specified iterable.

Specified by:

concatenate in interface LazyIterable<T>

collectIf

public <V> LazyIterable<V> collectIf(Predicate<? super T> predicate,
 Function<? super T,? extends V> function)

Description copied from interface: LazyIterable

Creates a deferred iterable for selecting and collecting elements from the current iterable.

Specified by:

collectIf in interface LazyIterable<T>

Specified by:

collectIf in interface RichIterable<T>

take

public LazyIterable<T> take(int count)

Description copied from interface: LazyIterable

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

Specified by:

take in interface LazyIterable<T>

drop

public LazyIterable<T> drop(int count)

Description copied from interface: LazyIterable

Creates a deferred drop iterable for the current iterable using the specified count as the limit.

Specified by:

drop in interface LazyIterable<T>

takeWhile

public LazyIterable<T> takeWhile(Predicate<? super T> predicate)

Specified by:

takeWhile in interface LazyIterable<T>

See Also:

• OrderedIterable.takeWhile(Predicate)

dropWhile

public LazyIterable<T> dropWhile(Predicate<? super T> predicate)

Specified by:

dropWhile in interface LazyIterable<T>

See Also:

• OrderedIterable.dropWhile(Predicate)

distinct

public LazyIterable<T> distinct()

Description copied from interface: LazyIterable

Creates a deferred distinct iterable to get distinct elements from the current iterable.

Specified by:

distinct in interface LazyIterable<T>

toStack

public MutableStack<T> toStack()

groupBy

public <V> Multimap<V,T> groupBy(Function<? super T,? extends V> function)

Description copied from interface: RichIterable

For each element of the iterable, the function is evaluated and the results of these evaluations are collected into a new multimap, where the transformed value is the key and the original values are added to the same (or similar) species of collection as the source iterable.

Example using a Java 8 method reference:

 Multimap<String, Person> peopleByLastName =
     people.groupBy(Person::getLastName);
 

Example using an anonymous inner class:

 Multimap<String, Person> peopleByLastName =
     people.groupBy(new Function<Person, String>()
     {
         public String valueOf(Person person)
         {
             return person.getLastName();
         }
     });
 

Specified by:

groupBy in interface RichIterable<T>

groupByEach

public <V> Multimap<V,T> groupByEach(Function<? super T,? extends Iterable<V>> function)

Description copied from interface: RichIterable

Similar to RichIterable.groupBy(Function), except the result of evaluating function will return a collection of keys for each value.

Specified by:

groupByEach in interface RichIterable<T>

groupByUniqueKey

public <V> MapIterable<V,T> groupByUniqueKey(Function<? super T,? extends V> function)

Description copied from interface: RichIterable

For each element of the iterable, the function is evaluated, and the results of these evaluations are collected into a new map, where the transformed value is the key. The generated keys must each be unique, or else an exception is thrown.

Specified by:

groupByUniqueKey in interface RichIterable<T>

See Also:

• RichIterable.groupBy(Function)

zip

public <S> LazyIterable<Pair<T,S>> zip(Iterable<S> that)

Description copied from interface: LazyIterable

Creates a deferred zip iterable.

Specified by:

zip in interface LazyIterable<T>

Specified by:

zip in interface RichIterable<T>

Type Parameters:

S - the type of the second half of the returned pairs

Parameters:

that - The RichIterable providing the second half of each result pair

Returns:

A new RichIterable containing pairs consisting of corresponding elements of this RichIterable and that. The length of the returned RichIterable is the minimum of the lengths of this RichIterable and that.

zipWithIndex

public LazyIterable<Pair<T,Integer>> zipWithIndex()

Description copied from interface: LazyIterable

Creates a deferred zipWithIndex iterable.

Specified by:

zipWithIndex in interface LazyIterable<T>

Specified by:

zipWithIndex in interface RichIterable<T>

Returns:

A new RichIterable containing pairs consisting of all elements of this RichIterable paired with their index. Indices start at 0.

See Also:

• RichIterable.zip(Iterable)

chunk

public LazyIterable<RichIterable<T>> chunk(int size)

Description copied from interface: LazyIterable

Creates a deferred chunk iterable.

Specified by:

chunk in interface LazyIterable<T>

Specified by:

chunk in interface RichIterable<T>

Parameters:

size - the number of elements per chunk

Returns:

A RichIterable containing RichIterables of size size, except the last will be truncated if the elements don't divide evenly.

tap

public LazyIterable<T> tap(Procedure<? super T> procedure)

Description copied from interface: LazyIterable

Creates a deferred tap iterable.

Specified by:

tap in interface LazyIterable<T>

Specified by:

tap in interface RichIterable<T>

See Also:

• RichIterable.each(Procedure)
• RichIterable.forEach(Procedure)

sumByInt

public <V> ObjectLongMap<V> sumByInt(Function<? super T,? extends V> groupBy,
 IntFunction<? super T> function)

Description copied from interface: RichIterable

Groups and sums the values using the two specified functions.

Specified by:

sumByInt in interface RichIterable<T>

sumByFloat

public <V> ObjectDoubleMap<V> sumByFloat(Function<? super T,? extends V> groupBy,
 FloatFunction<? super T> function)

Description copied from interface: RichIterable

Groups and sums the values using the two specified functions.

Specified by:

sumByFloat in interface RichIterable<T>

sumByLong

public <V> ObjectLongMap<V> sumByLong(Function<? super T,? extends V> groupBy,
 LongFunction<? super T> function)

Description copied from interface: RichIterable

Groups and sums the values using the two specified functions.

Specified by:

sumByLong in interface RichIterable<T>

sumByDouble

public <V> ObjectDoubleMap<V> sumByDouble(Function<? super T,? extends V> groupBy,
 DoubleFunction<? super T> function)

Description copied from interface: RichIterable

Groups and sums the values using the two specified functions.

Specified by:

sumByDouble in interface RichIterable<T>

minOptional

public Optional<T> minOptional(Comparator<? super T> comparator)

Description copied from interface: RichIterable

Returns the minimum element out of this container based on the comparator as an Optional. If the container is empty Optional.empty() is returned.

Specified by:

minOptional in interface RichIterable<T>

maxOptional

public Optional<T> maxOptional(Comparator<? super T> comparator)

Description copied from interface: RichIterable

Returns the maximum element out of this container based on the comparator as an Optional. If the container is empty Optional.empty() is returned.

Specified by:

maxOptional in interface RichIterable<T>

minOptional

public Optional<T> minOptional()

Description copied from interface: RichIterable

Returns the minimum element out of this container based on the natural order as an Optional. If the container is empty Optional.empty() is returned.

Specified by:

minOptional in interface RichIterable<T>

maxOptional

public Optional<T> maxOptional()

Description copied from interface: RichIterable

Returns the maximum element out of this container based on the natural order as an Optional. If the container is empty Optional.empty() is returned.

Specified by:

maxOptional in interface RichIterable<T>

minByOptional

public <V extends Comparable<? super V>>
Optional<T> minByOptional(Function<? super T,? extends V> function)

Description copied from interface: RichIterable

Returns the minimum elements out of this container based on the natural order of the attribute returned by Function as an Optional. If the container is empty Optional.empty() is returned.

Specified by:

minByOptional in interface RichIterable<T>

maxByOptional

public <V extends Comparable<? super V>>
Optional<T> maxByOptional(Function<? super T,? extends V> function)

Description copied from interface: RichIterable

Returns the maximum elements out of this container based on the natural order of the attribute returned by Function as an Optional. If the container is empty Optional.empty() is returned.

Specified by:

maxByOptional in interface RichIterable<T>