Package eu.bandm.tools.util.java

Class Iterables

java.lang.Object

eu.bandm.tools.util.java.Iterables

public final class Iterables
extends Object

Library of constants and combinators for classes implementing Iterable.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Iterables.Cached<A>
static class	Iterables.FilterIterable<A>	Deprecated, for removal: This API element is subject to removal in a future version. use filter(java.util.function.Predicate<? super A>, java.lang.Iterable<A>) instead.

Method Summary

Modifier and Type	Method	Description
static <A, B> boolean	allZip(BiPredicate<? super A,? super B> rel, Iterable<? extends A> left, Iterable<? extends B> right)
static <E> Optional<E>	anyOf(Iterable<E> things)
static <A, B> boolean	anyZip(BiPredicate<? super A,? super B> rel, Iterable<? extends A> left, Iterable<? extends B> right)
static <A, B, C> Iterable<C>	asProduct(BiFunction<? super A,? super B,? extends C> fun, Iterable<? extends A> left, Iterable<? extends B> right)	Deprecated, for removal: This API element is subject to removal in a future version. use streams instead.
static <A, B> Iterable<B>	bind(Function<? super A,? extends Iterable<? extends B>> fun, Iterable<A> items)	Deprecated, for removal: This API element is subject to removal in a future version. use flatMap(java.util.function.Function<? super A, ? extends java.lang.Iterable<? extends B>>, java.lang.Iterable<A>) instead.
static <A> Iterables.Cached<A>	cache(Iterable<A> things)
static <A, B> Iterable<B>	comprehend(Iterable<A> gen, Function<? super A,? extends Iterable<? extends B>> map)	Deprecated. use streams instead
static <A, B> Iterable<B>	comprehend(Iterable<A> gen, Predicate<? super A> filter, Function<? super A,? extends B> map)	Deprecated. use streams instead
static <A> Iterable<A>	concat(Iterable<? extends A> first, Iterable<? extends A> second)
static <A> Iterable<A>	cons(A first, Iterable<A> rest)
static <A> Iterable<A>	drop(int offset, Iterable<A> things)
static <A> Iterable<A>	dropTake(int offset, int length, Iterable<A> things)
static <A> void	elementwise(Consumer<? super A> sink, Iterable<A> things)	Deprecated, for removal: This API element is subject to removal in a future version. use Iterable.forEach(java.util.function.Consumer<? super T>) instead.
static <A> Iterable<A>	empty()
static <A> Iterable<A>	filter(Predicate<? super A> pred, Iterable<A> things)
static <A, B> Iterable<A>	filterWithConstraint(BiPredicate<? super A,? super B> rel, Iterable<A> things, Iterable<B> constraints)
static <E> Optional<E>	firstOf(Iterable<E> things)
static <A, B> Iterable<B>	flatMap(Function<? super A,? extends Iterable<? extends B>> fun, Iterable<A> items)
static <A> Iterable<A>	flatten(Iterable<? extends Iterable<? extends A>> items)
static <A, B> Iterable<B>	map(Function<? super A,? extends B> fun, Iterable<? extends A> things)
static <A> Iterable<A>	merge(Comparator<? super A> order, boolean removeDuplicates, Iterable<? extends A> left, Iterable<? extends A> right)
static <A> Iterable<A>	next(Iterable<A> things)
static <E> Iterable<E>	of(E... things)
static <A> Iterable<A>	singleton(A item)
static <A> Iterable<A>	take(int length, Iterable<A> things)

Methods inherited from class java.lang.Object

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

Method Details

empty

public static <A> Iterable<A> empty()

map

public static <A,
B> Iterable<B> map(Function<? super A,? extends B> fun,
 Iterable<? extends A> things)

singleton

public static <A> Iterable<A> singleton(A item)

of

@SafeVarargs
public static <E> Iterable<E> of(E... things)

flatten

public static <A> Iterable<A> flatten(Iterable<? extends Iterable<? extends A>> items)

bind

@Deprecated(forRemoval=true,
            since="1.0")
public static <A,
B> Iterable<B> bind(Function<? super A,? extends Iterable<? extends B>> fun,
 Iterable<A> items)

Deprecated, for removal: This API element is subject to removal in a future version.

use flatMap(java.util.function.Function<? super A, ? extends java.lang.Iterable<? extends B>>, java.lang.Iterable<A>) instead.

flatMap

public static <A,
B> Iterable<B> flatMap(Function<? super A,? extends Iterable<? extends B>> fun,
 Iterable<A> items)

cons

public static <A> Iterable<A> cons(A first,
 Iterable<A> rest)

concat

public static <A> Iterable<A> concat(Iterable<? extends A> first,
 Iterable<? extends A> second)

filter

public static <A> Iterable<A> filter(Predicate<? super A> pred,
 Iterable<A> things)

comprehend

@Deprecated(since="0.0")
public static <A,
B> Iterable<B> comprehend(Iterable<A> gen,
 Predicate<? super A> filter,
 Function<? super A,? extends B> map)

Deprecated.

use streams instead

First apply filter, than map, and collect results.

comprehend

@Deprecated(since="0.0")
public static <A,
B> Iterable<B> comprehend(Iterable<A> gen,
 Function<? super A,? extends Iterable<? extends B>> map)

Deprecated.

use streams instead

Apply function and collect results.

cache

public static <A> Iterables.Cached<A> cache(Iterable<A> things)

next

public static <A> Iterable<A> next(Iterable<A> things)

allZip

public static <A,
B> boolean allZip(BiPredicate<? super A,? super B> rel,
 Iterable<? extends A> left,
 Iterable<? extends B> right)

anyZip

public static <A,
B> boolean anyZip(BiPredicate<? super A,? super B> rel,
 Iterable<? extends A> left,
 Iterable<? extends B> right)

asProduct

@Deprecated(forRemoval=true,
            since="1.0")
public static <A,
B,
C> Iterable<C> asProduct(BiFunction<? super A,? super B,? extends C> fun,
 Iterable<? extends A> left,
 Iterable<? extends B> right)

Deprecated, for removal: This API element is subject to removal in a future version.

use streams instead.

merge

public static <A> Iterable<A> merge(Comparator<? super A> order,
 boolean removeDuplicates,
 Iterable<? extends A> left,
 Iterable<? extends A> right)

filterWithConstraint

public static <A,
B> Iterable<A> filterWithConstraint(BiPredicate<? super A,? super B> rel,
 Iterable<A> things,
 Iterable<B> constraints)

drop

public static <A> Iterable<A> drop(int offset,
 Iterable<A> things)

take

public static <A> Iterable<A> take(int length,
 Iterable<A> things)

dropTake

public static <A> Iterable<A> dropTake(int offset,
 int length,
 Iterable<A> things)

elementwise

@Deprecated(forRemoval=true,
            since="1.0")
public static <A> void elementwise(Consumer<? super A> sink,
 Iterable<A> things)

Deprecated, for removal: This API element is subject to removal in a future version.

use Iterable.forEach(java.util.function.Consumer<? super T>) instead.

anyOf

public static <E> Optional<E> anyOf(Iterable<E> things)

firstOf

public static <E> Optional<E> firstOf(Iterable<E> things)