ix

Class Ix<T>

java.lang.Object

ix.Ix<T>

Type Parameters:

T - the value type

All Implemented Interfaces:

java.lang.Iterable<T>

Direct Known Subclasses:

GroupedIx

public abstract class Ix<T>
extends java.lang.Object
implements java.lang.Iterable<T>

Base class and entry point for fluent iterables.

Since:

1.0

Constructor Summary

Constructors

Constructor and Description
Ix()

Method Summary

Modifier and Type	Method and Description
Ix<java.lang.Boolean>	all(Pred<? super T> predicate)
Ix<java.lang.Boolean>	any(Pred<? super T> predicate)
<R> R	as(rx.functions.Func1<? super Ix<T>,R> transformer)
Ix<java.util.List<T>>	buffer(int size)
Ix<java.util.List<T>>	buffer(int size, int skip)
static Ix<java.lang.Integer>	characters(java.lang.CharSequence cs)
static Ix<java.lang.Integer>	characters(java.lang.CharSequence cs, int start, int end)
protected static <U> U	checkedCall(java.util.concurrent.Callable<U> callable) Calls the given callable and rethrows its exception (as RuntimeException if necessary).
<C> Ix<C>	collect(rx.functions.Func0<C> initialFactory, rx.functions.Action2<C,T> collector)
<R> Ix<R>	compose(rx.functions.Func1<? super Ix<T>,? extends java.lang.Iterable<? extends R>> transformer)
static <T> Ix<T>	concat(java.lang.Iterable<? extends java.lang.Iterable<? extends T>> sources)
static <T> Ix<T>	concatArray(java.lang.Iterable<? extends T>... sources)
<R> Ix<R>	concatMap(rx.functions.Func1<? super T,? extends java.lang.Iterable<? extends R>> mapper)
Ix<T>	concatWith(java.lang.Iterable<? extends T> other)
Ix<java.lang.Boolean>	contains(java.lang.Object o)
Ix<java.lang.Integer>	count()
Ix<java.lang.Long>	countLong()
static <T> Ix<T>	defer(rx.functions.Func0<? extends java.lang.Iterable<? extends T>> factory)
Ix<T>	distinct()
<K> Ix<T>	distinct(rx.functions.Func1<? super T,K> keySelector)
Ix<T>	distinctUntilChanged()
<K> Ix<T>	distinctUntilChanged(rx.functions.Func1<? super T,K> keySelector)
Ix<T>	distinctUntilChanged(Pred2<? super T,? super T> comparer)
Ix<T>	doOnCompleted(rx.functions.Action0 action)
Ix<T>	doOnNext(rx.functions.Action1<? super T> action)
static <T> Ix<T>	empty()
Ix<T>	endWith(T... values)
Ix<T>	filter(Pred<T> predicate)
T	first()
T	first(T defaultValue)
<R> Ix<R>	flatMap(rx.functions.Func1<? super T,? extends java.lang.Iterable<? extends R>> mapper)
void	foreach(rx.functions.Action1<? super T> action)
void	foreachWhile(Pred<? super T> action)
static <T,R> Ix<R>	forloop(T seed, Pred<? super T> condition, rx.functions.Func1<? super T,? extends T> next, rx.functions.Func1<? super T,? extends R> selector)
static <T> Ix<T>	from(java.lang.Iterable<T> source)
static <T> Ix<T>	fromArray(T... values)
static <T> Ix<T>	fromArrayRange(int start, int end, T... values)
static <T> Ix<T>	generate(rx.functions.Action1<rx.Observer<T>> nextSupplier)
static <T,S> Ix<T>	generate(rx.functions.Func0<S> stateSupplier, rx.functions.Func2<S,rx.Observer<T>,S> nextSupplier)
static <T,S> Ix<T>	generate(rx.functions.Func0<S> stateSupplier, rx.functions.Func2<S,rx.Observer<T>,S> nextSupplier, rx.functions.Action1<? super S> stateDisposer)
<K> Ix<GroupedIx<K,T>>	groupBy(rx.functions.Func1<? super T,? extends K> keySelector)
<K,V> Ix<GroupedIx<K,V>>	groupBy(rx.functions.Func1<? super T,? extends K> keySelector, rx.functions.Func1<? super T,? extends V> valueSelector)
Ix<java.lang.Boolean>	hasElements()
Ix<T>	hide()
Ix<T>	ignoreElements()
<U extends java.util.Collection<? super T>> U	into(U collection)
Ix<java.lang.String>	join()
Ix<java.lang.String>	join(java.lang.CharSequence separator)
static <T> Ix<T>	just(T value)
T	last()
T	last(T defaultValue)
<R> Ix<R>	lift(rx.functions.Func1<? super java.util.Iterator<T>,? extends java.util.Iterator<R>> lifter)
<R> Ix<R>	map(rx.functions.Func1<? super T,? extends R> mapper)
Ix<T>	max()
Ix<T>	max(java.util.Comparator<? super T> comparator)
Ix<java.lang.Integer>	maxInt()
Ix<java.lang.Long>	maxLong()
static <T> Ix<T>	merge(java.lang.Iterable<? extends java.lang.Iterable<? extends T>> sources)
static <T> Ix<T>	mergeArray(java.lang.Iterable<? extends T>... sources)
Ix<T>	mergeWith(java.lang.Iterable<? extends T> other)
Ix<T>	min()
Ix<T>	min(java.util.Comparator<? super T> comparator)
Ix<java.lang.Integer>	minInt()
Ix<java.lang.Long>	minLong()
protected static <U> U	nullCheck(U value, java.lang.String message) Checks if the value is null and if so, throws a NullPointerException with the given message.
Ix<T>	orderBy()
Ix<T>	orderBy(java.util.Comparator<? super T> comparator)
<K extends java.lang.Comparable<? super K>> Ix<T>	orderBy(rx.functions.Func1<? super T,K> keySelector)
void	print()
void	print(java.lang.CharSequence separator, int charsPerLine)
void	println()
void	println(java.lang.CharSequence prefix)
Ix<T>	publish()
<R> Ix<R>	publish(rx.functions.Func1<? super Ix<T>,? extends java.util.Iterator<? extends R>> transform)
static Ix<java.lang.Integer>	range(int start, int count)
<C> Ix<C>	reduce(rx.functions.Func0<C> initialFactory, rx.functions.Func2<C,T,C> reducer)
Ix<T>	reduce(rx.functions.Func2<T,T,T> reducer)
Ix<T>	remove(Pred<? super T> predicate)
void	removeAll()
void	removeAll(Pred<? super T> predicate) Consumes this Iterable and removes all elements for which the predicate returns true; in other words, remove those elements of a mutable source that match the predicate.
Ix<T>	repeat()
Ix<T>	repeat(long times)
Ix<T>	repeat(long times, Pred0 predicate)
Ix<T>	repeat(Pred0 predicate)
static <T> Ix<T>	repeatValue(T value)
static <T> Ix<T>	repeatValue(T value, long count)
static <T> Ix<T>	repeatValue(T value, long count, Pred0 stopPredicate)
static <T> Ix<T>	repeatValue(T value, Pred0 stopPredicate)
Ix<T>	replay()
<R> Ix<R>	replay(rx.functions.Func1<? super Ix<T>,? extends java.util.Iterator<? extends R>> transform)
Ix<T>	replay(int size)
<R> Ix<R>	replay(int size, rx.functions.Func1<? super Ix<T>,? extends java.util.Iterator<? extends R>> transform)
void	retainAll(Pred<? super T> predicate) Consumes this Iterable and removes all elements for which the predicate returns false; in other words, retain those elements of a mutable source that match the predicate.
void	run() Iterates over this instance, dropping all values it produces.
<R> Ix<R>	scan(rx.functions.Func0<R> initialFactory, rx.functions.Func2<R,T,R> scanner)
Ix<T>	scan(rx.functions.Func2<T,T,T> scanner)
Ix<T>	skip(int n)
Ix<T>	skipLast(int n)
Ix<T>	skipWhile(Pred<? super T> predicate)
static Ix<java.lang.String>	split(java.lang.String string, java.lang.String by)
Ix<T>	startWith(T... values)
void	subscribe()
void	subscribe(rx.functions.Action1<? super T> consumer)
void	subscribe(rx.functions.Action1<? super T> consumer, rx.functions.Action1<java.lang.Throwable> onError)
void	subscribe(rx.functions.Action1<? super T> consumer, rx.functions.Action1<java.lang.Throwable> onError, rx.functions.Action0 onCompleted)
void	subscribe(rx.Observer<? super T> observer)
void	subscribe(rx.Subscriber<? super T> subscriber)
Ix<java.lang.Integer>	sumInt()
Ix<java.lang.Long>	sumLong()
Ix<T>	take(int n)
Ix<T>	takeLast(int n)
Ix<T>	takeUntil(Pred<? super T> stopPredicate)
Ix<T>	takeWhile(Pred<? super T> predicate)
Ix<java.lang.Object[]>	toArray()
Ix<java.util.List<T>>	toList()
Ix<java.lang.Long>	toLong()
<K> Ix<java.util.Map<K,T>>	toMap(rx.functions.Func1<? super T,? extends K> keySelector)
<K,V> Ix<java.util.Map<K,V>>	toMap(rx.functions.Func1<? super T,? extends K> keySelector, rx.functions.Func1<? super T,? extends V> valueSelector)
<K> Ix<java.util.Map<K,java.util.Collection<T>>>	toMultimap(rx.functions.Func1<? super T,? extends K> keySelector)
<K,V> Ix<java.util.Map<K,java.util.Collection<V>>>	toMultimap(rx.functions.Func1<? super T,? extends K> keySelector, rx.functions.Func1<? super T,? extends V> valueSelector)
<R> Ix<R>	transform(IxTransform<T,R> transformer)
Ix<Ix<T>>	window(int size)
Ix<Ix<T>>	window(int size, int skip)
static <T,R> Ix<R>	zip(java.lang.Iterable<? extends java.lang.Iterable<? extends T>> sources, rx.functions.FuncN<R> zipper)
static <T,R> Ix<R>	zip(java.lang.Iterable<? extends T>[] sources, rx.functions.FuncN<R> zipper)
static <T1,T2,R> Ix<R>	zip(java.lang.Iterable<T1> it1, java.lang.Iterable<T2> it2, rx.functions.Func2<? super T1,? super T2,? extends R> zipper)
static <T1,T2,T3,R> Ix<R>	zip(java.lang.Iterable<T1> it1, java.lang.Iterable<T2> it2, java.lang.Iterable<T3> it3, rx.functions.Func3<? super T1,? super T2,? super T3,? extends R> zipper)
static <T1,T2,T3,T4,R> Ix<R>	zip(java.lang.Iterable<T1> it1, java.lang.Iterable<T2> it2, java.lang.Iterable<T3> it3, java.lang.Iterable<T4> it4, rx.functions.Func4<? super T1,? super T2,? super T3,? super T4,? extends R> zipper)
<U,R> Ix<R>	zipWith(java.lang.Iterable<U> other, rx.functions.Func2<? super T,? super U,? extends R> zipper)

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, iterator, spliterator

Constructor Detail

Ix

public Ix()

Method Detail

just

public static <T> Ix<T> just(T value)

empty

public static <T> Ix<T> empty()

from

public static <T> Ix<T> from(java.lang.Iterable<T> source)

range

public static Ix<java.lang.Integer> range(int start,
                                          int count)

characters

public static Ix<java.lang.Integer> characters(java.lang.CharSequence cs)

characters

public static Ix<java.lang.Integer> characters(java.lang.CharSequence cs,
                                               int start,
                                               int end)

fromArray

public static <T> Ix<T> fromArray(T... values)

fromArrayRange

public static <T> Ix<T> fromArrayRange(int start,
                                       int end,
                                       T... values)

concatArray

public static <T> Ix<T> concatArray(java.lang.Iterable<? extends T>... sources)

mergeArray

public static <T> Ix<T> mergeArray(java.lang.Iterable<? extends T>... sources)

concat

public static <T> Ix<T> concat(java.lang.Iterable<? extends java.lang.Iterable<? extends T>> sources)

merge

public static <T> Ix<T> merge(java.lang.Iterable<? extends java.lang.Iterable<? extends T>> sources)

defer

public static <T> Ix<T> defer(rx.functions.Func0<? extends java.lang.Iterable<? extends T>> factory)

generate

public static <T> Ix<T> generate(rx.functions.Action1<rx.Observer<T>> nextSupplier)

generate

public static <T,S> Ix<T> generate(rx.functions.Func0<S> stateSupplier,
                                   rx.functions.Func2<S,rx.Observer<T>,S> nextSupplier)

generate

public static <T,S> Ix<T> generate(rx.functions.Func0<S> stateSupplier,
                                   rx.functions.Func2<S,rx.Observer<T>,S> nextSupplier,
                                   rx.functions.Action1<? super S> stateDisposer)

zip

public static <T,R> Ix<R> zip(java.lang.Iterable<? extends T>[] sources,
                              rx.functions.FuncN<R> zipper)

zip

public static <T,R> Ix<R> zip(java.lang.Iterable<? extends java.lang.Iterable<? extends T>> sources,
                              rx.functions.FuncN<R> zipper)

zip

public static <T1,T2,R> Ix<R> zip(java.lang.Iterable<T1> it1,
                                  java.lang.Iterable<T2> it2,
                                  rx.functions.Func2<? super T1,? super T2,? extends R> zipper)

zip

public static <T1,T2,T3,R> Ix<R> zip(java.lang.Iterable<T1> it1,
                                     java.lang.Iterable<T2> it2,
                                     java.lang.Iterable<T3> it3,
                                     rx.functions.Func3<? super T1,? super T2,? super T3,? extends R> zipper)

zip

public static <T1,T2,T3,T4,R> Ix<R> zip(java.lang.Iterable<T1> it1,
                                        java.lang.Iterable<T2> it2,
                                        java.lang.Iterable<T3> it3,
                                        java.lang.Iterable<T4> it4,
                                        rx.functions.Func4<? super T1,? super T2,? super T3,? super T4,? extends R> zipper)

repeatValue

public static <T> Ix<T> repeatValue(T value)

repeatValue

public static <T> Ix<T> repeatValue(T value,
                                    long count)

repeatValue

public static <T> Ix<T> repeatValue(T value,
                                    Pred0 stopPredicate)

repeatValue

public static <T> Ix<T> repeatValue(T value,
                                    long count,
                                    Pred0 stopPredicate)

forloop

public static <T,R> Ix<R> forloop(T seed,
                                  Pred<? super T> condition,
                                  rx.functions.Func1<? super T,? extends T> next,
                                  rx.functions.Func1<? super T,? extends R> selector)

split

public static Ix<java.lang.String> split(java.lang.String string,
                                         java.lang.String by)

as

public final <R> R as(rx.functions.Func1<? super Ix<T>,R> transformer)

compose

public final <R> Ix<R> compose(rx.functions.Func1<? super Ix<T>,? extends java.lang.Iterable<? extends R>> transformer)

any

public final Ix<java.lang.Boolean> any(Pred<? super T> predicate)

all

public final Ix<java.lang.Boolean> all(Pred<? super T> predicate)

hasElements

public final Ix<java.lang.Boolean> hasElements()

ignoreElements

public final Ix<T> ignoreElements()

max

public final Ix<T> max(java.util.Comparator<? super T> comparator)

max

public final Ix<T> max()

min

public final Ix<T> min(java.util.Comparator<? super T> comparator)

min

public final Ix<T> min()

contains

public final Ix<java.lang.Boolean> contains(java.lang.Object o)

count

public final Ix<java.lang.Integer> count()

countLong

public final Ix<java.lang.Long> countLong()

distinct

public final Ix<T> distinct()

distinct

public final <K> Ix<T> distinct(rx.functions.Func1<? super T,K> keySelector)

distinctUntilChanged

public final Ix<T> distinctUntilChanged()

distinctUntilChanged

public final Ix<T> distinctUntilChanged(Pred2<? super T,? super T> comparer)

distinctUntilChanged

public final <K> Ix<T> distinctUntilChanged(rx.functions.Func1<? super T,K> keySelector)

doOnNext

public final Ix<T> doOnNext(rx.functions.Action1<? super T> action)

doOnCompleted

public final Ix<T> doOnCompleted(rx.functions.Action0 action)

startWith

public final Ix<T> startWith(T... values)

endWith

public final Ix<T> endWith(T... values)

join

public final Ix<java.lang.String> join()

join

public final Ix<java.lang.String> join(java.lang.CharSequence separator)

map

public final <R> Ix<R> map(rx.functions.Func1<? super T,? extends R> mapper)

filter

public final Ix<T> filter(Pred<T> predicate)

collect

public final <C> Ix<C> collect(rx.functions.Func0<C> initialFactory,
                               rx.functions.Action2<C,T> collector)

reduce

public final <C> Ix<C> reduce(rx.functions.Func0<C> initialFactory,
                              rx.functions.Func2<C,T,C> reducer)

hide

public final Ix<T> hide()

toList

public final Ix<java.util.List<T>> toList()

toArray

public final Ix<java.lang.Object[]> toArray()

reduce

public final Ix<T> reduce(rx.functions.Func2<T,T,T> reducer)

maxInt

public final Ix<java.lang.Integer> maxInt()

minInt

public final Ix<java.lang.Integer> minInt()

sumInt

public final Ix<java.lang.Integer> sumInt()

maxLong

public final Ix<java.lang.Long> maxLong()

minLong

public final Ix<java.lang.Long> minLong()

sumLong

public final Ix<java.lang.Long> sumLong()

toLong

public final Ix<java.lang.Long> toLong()

skip

public final Ix<T> skip(int n)

take

public final Ix<T> take(int n)

skipLast

public final Ix<T> skipLast(int n)

takeLast

public final Ix<T> takeLast(int n)

flatMap

public final <R> Ix<R> flatMap(rx.functions.Func1<? super T,? extends java.lang.Iterable<? extends R>> mapper)

concatMap

public final <R> Ix<R> concatMap(rx.functions.Func1<? super T,? extends java.lang.Iterable<? extends R>> mapper)

skipWhile

public final Ix<T> skipWhile(Pred<? super T> predicate)

takeWhile

public final Ix<T> takeWhile(Pred<? super T> predicate)

takeUntil

public final Ix<T> takeUntil(Pred<? super T> stopPredicate)

buffer

public final Ix<java.util.List<T>> buffer(int size)

buffer

public final Ix<java.util.List<T>> buffer(int size,
                                          int skip)

groupBy

public final <K> Ix<GroupedIx<K,T>> groupBy(rx.functions.Func1<? super T,? extends K> keySelector)

groupBy

public final <K,V> Ix<GroupedIx<K,V>> groupBy(rx.functions.Func1<? super T,? extends K> keySelector,
                                              rx.functions.Func1<? super T,? extends V> valueSelector)

repeat

public final Ix<T> repeat()

repeat

public final Ix<T> repeat(long times)

repeat

public final Ix<T> repeat(Pred0 predicate)

repeat

public final Ix<T> repeat(long times,
                          Pred0 predicate)

publish

public final Ix<T> publish()

publish

public final <R> Ix<R> publish(rx.functions.Func1<? super Ix<T>,? extends java.util.Iterator<? extends R>> transform)

replay

public final Ix<T> replay()

replay

public final Ix<T> replay(int size)

replay

public final <R> Ix<R> replay(rx.functions.Func1<? super Ix<T>,? extends java.util.Iterator<? extends R>> transform)

replay

public final <R> Ix<R> replay(int size,
                              rx.functions.Func1<? super Ix<T>,? extends java.util.Iterator<? extends R>> transform)

toMap

public final <K> Ix<java.util.Map<K,T>> toMap(rx.functions.Func1<? super T,? extends K> keySelector)

toMap

public final <K,V> Ix<java.util.Map<K,V>> toMap(rx.functions.Func1<? super T,? extends K> keySelector,
                                                rx.functions.Func1<? super T,? extends V> valueSelector)

toMultimap

public final <K> Ix<java.util.Map<K,java.util.Collection<T>>> toMultimap(rx.functions.Func1<? super T,? extends K> keySelector)

toMultimap

public final <K,V> Ix<java.util.Map<K,java.util.Collection<V>>> toMultimap(rx.functions.Func1<? super T,? extends K> keySelector,
                                                                           rx.functions.Func1<? super T,? extends V> valueSelector)

window

public final Ix<Ix<T>> window(int size)

window

public final Ix<Ix<T>> window(int size,
                              int skip)

concatWith

public final Ix<T> concatWith(java.lang.Iterable<? extends T> other)

mergeWith

public final Ix<T> mergeWith(java.lang.Iterable<? extends T> other)

zipWith

public final <U,R> Ix<R> zipWith(java.lang.Iterable<U> other,
                                 rx.functions.Func2<? super T,? super U,? extends R> zipper)

orderBy

public final Ix<T> orderBy()

orderBy

public final Ix<T> orderBy(java.util.Comparator<? super T> comparator)

orderBy

public final <K extends java.lang.Comparable<? super K>> Ix<T> orderBy(rx.functions.Func1<? super T,K> keySelector)

scan

public final Ix<T> scan(rx.functions.Func2<T,T,T> scanner)

scan

public final <R> Ix<R> scan(rx.functions.Func0<R> initialFactory,
                            rx.functions.Func2<R,T,R> scanner)

remove

public final Ix<T> remove(Pred<? super T> predicate)

transform

public final <R> Ix<R> transform(IxTransform<T,R> transformer)

lift

public final <R> Ix<R> lift(rx.functions.Func1<? super java.util.Iterator<T>,? extends java.util.Iterator<R>> lifter)

first

public final T first()

first

public final T first(T defaultValue)

last

public final T last()

last

public final T last(T defaultValue)

removeAll

public final void removeAll()

foreach

public final void foreach(rx.functions.Action1<? super T> action)

foreachWhile

public final void foreachWhile(Pred<? super T> action)

into

public final <U extends java.util.Collection<? super T>> U into(U collection)

print

public final void print()

print

public final void print(java.lang.CharSequence separator,
                        int charsPerLine)

println

public final void println()

println

public final void println(java.lang.CharSequence prefix)

run

public final void run()

Iterates over this instance, dropping all values it produces.

subscribe

public final void subscribe()

subscribe

public final void subscribe(rx.functions.Action1<? super T> consumer)

subscribe

public final void subscribe(rx.functions.Action1<? super T> consumer,
                            rx.functions.Action1<java.lang.Throwable> onError)

subscribe

public final void subscribe(rx.functions.Action1<? super T> consumer,
                            rx.functions.Action1<java.lang.Throwable> onError,
                            rx.functions.Action0 onCompleted)

subscribe

public final void subscribe(rx.Observer<? super T> observer)

subscribe

public final void subscribe(rx.Subscriber<? super T> subscriber)

retainAll

public final void retainAll(Pred<? super T> predicate)

Consumes this Iterable and removes all elements for which the predicate returns false; in other words, retain those elements of a mutable source that match the predicate.

Parameters:

predicate - the predicate called with the current element and should return true for elements to keep, false for elements to remove.

Throws:

java.lang.UnsupportedOperationException - if the this Iterable doesn't allow removing elements.

Since:

1.0

See Also:

removeAll(Pred)

removeAll

public final void removeAll(Pred<? super T> predicate)

Consumes this Iterable and removes all elements for which the predicate returns true; in other words, remove those elements of a mutable source that match the predicate.

Parameters:

predicate - the predicate called with the current element and should return true for elements to remove, false for elements to keep.

Throws:

java.lang.UnsupportedOperationException - if the this Iterable doesn't allow removing elements.

Since:

1.0

See Also:

retainAll(Pred), removeAll()

nullCheck

protected static <U> U nullCheck(U value,
                                 java.lang.String message)

Checks if the value is null and if so, throws a NullPointerException with the given message.

Type Parameters:

U - the value type

Parameters:

value - the value to check for null

message - the message to report in the exception

Returns:

the value

checkedCall

protected static <U> U checkedCall(java.util.concurrent.Callable<U> callable)

Calls the given callable and rethrows its exception (as RuntimeException if necessary).

Type Parameters:

U - the value type

Parameters:

callable - the callable to call

Returns:

the value returned by the callable