/**

* Copyright 2014 Netflix, Inc.

*

* Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in

* compliance with the License. You may obtain a copy of the License at

*

* http://www.apache.org/licenses/LICENSE-2.0

*

* Unless required by applicable law or agreed to in writing, software distributed under the License is

* distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See

* the License for the specific language governing permissions and limitations under the License.

*/

package rx;

import static rx.functions.Functions.alwaysFalse;

import java.util.*;

import java.util.concurrent.*;

import rx.exceptions.*;

import rx.functions.*;

import rx.observables.*;

import rx.observers.SafeSubscriber;

import rx.operators.*;

import rx.plugins.*;

import rx.schedulers.*;

import rx.subjects.*;

import rx.subscriptions.Subscriptions;

/**

* The Observable class that implements the Reactive Pattern.

* <p>

* This class provides methods for subscribing to the Observable as well as delegate methods to the various

* Observers.

* <p>

* The documentation for this class makes use of marble diagrams. The following legend explains these diagrams:

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/legend.png">

* <p>

* For more information see the <a href="https://github.com/Netflix/RxJava/wiki/Observable">RxJava Wiki</a>

*

* @param <T>

* the type of the items emitted by the Observable

*/

public class Observable<T> {

final OnSubscribe<T> onSubscribe;

/**

* Creates an Observable with a Function to execute when it is subscribed to.

* <p>

* <em>Note:</em> Use {@link #create(OnSubscribe)} to create an Observable, instead of this constructor,

* unless you specifically have a need for inheritance.

*

* @param f

* {@link OnSubscribe} to be executed when {@link #subscribe(Subscriber)} is called

*/

protected Observable(OnSubscribe<T> f) {

this.onSubscribe = f;

}

private static final RxJavaObservableExecutionHook hook = RxJavaPlugins.getInstance().getObservableExecutionHook();

/**

* Returns an Observable that will execute the specified function when a {@link Subscriber} subscribes to

* it.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/create.png">

* <p>

* Write the function you pass to {@code create} so that it behaves as an Observable: It should invoke the

* Subscriber's {@link Subscriber#onNext onNext}, {@link Subscriber#onError onError}, and {@link Subscriber#onCompleted onCompleted} methods appropriately.

* <p>

* A well-formed Observable must invoke either the Subscriber's {@code onCompleted} method exactly once or

* its {@code onError} method exactly once.

* <p>

* See <a href="http://go.microsoft.com/fwlink/?LinkID=205219">Rx Design Guidelines (PDF)</a> for detailed

* information.

*

* @param <T>

* the type of the items that this Observable emits

* @param f

* a function that accepts an {@code Subscriber<T>}, and invokes its {@code onNext}, {@code onError}, and {@code onCompleted} methods as appropriate

* @return an Observable that, when a {@link Subscriber} subscribes to it, will execute the specified

* function

* @see <a href="https://github.com/Netflix/RxJava/wiki/Creating-Observables#wiki-create">RxJava Wiki: create()</a>

* @see <a href="http://msdn.microsoft.com/en-us/library/system.reactive.linq.observable.create.aspx">MSDN: Observable.Create</a>

*/

public final static <T> Observable<T> create(OnSubscribe<T> f) {

return new Observable<T>(hook.onCreate(f));

}

/**

* Invoked when Obserable.subscribe is called.

*/

public static interface OnSubscribe<T> extends Action1<Subscriber<? super T>> {

// cover for generics insanity

}

/**

* Operator function for lifting into an Observable.

*/

public interface Operator<R, T> extends Func1<Subscriber<? super R>, Subscriber<? super T>> {

// cover for generics insanity

}

/**

* @deprecated use {@link #create(OnSubscribe)}

*/

@Deprecated

public final static <T> Observable<T> create(final OnSubscribeFunc<T> f) {

return new Observable<T>(new OnSubscribe<T>() {

@Override

public void call(Subscriber<? super T> observer) {

Subscription s = f.onSubscribe(observer);

if (s != null && s != observer) {

observer.add(s);

}

}

});

}

/**

* @deprecated use {@link OnSubscribe}

*/

@Deprecated

public static interface OnSubscribeFunc<T> extends Function {

public Subscription onSubscribe(Observer<? super T> op);

}

/**

* Lifts a function to the current Observable and returns a new Observable that when subscribed to will pass

* the values of the current Observable through the Operator function.

* <p>

* In other words, this allows chaining Observers together on an Observable for acting on the values within

* the Observable.

* <p> {@code

* observable.map(...).filter(...).take(5).lift(new OperatorA()).lift(new OperatorB(...)).subscribe()

* }

*

* @param lift the Operator that implements the Observable-operating function to be applied to the source

* Observable

* @return an Observable that is the result of applying the lifted Operator to the source Observable

* @since 0.17

*/

public final <R> Observable<R> lift(final Operator<? extends R, ? super T> lift) {

return new Observable<R>(new OnSubscribe<R>() {

@Override

public void call(Subscriber<? super R> o) {

try {

onSubscribe.call(hook.onLift(lift).call(o));

} catch (Throwable e) {

// localized capture of errors rather than it skipping all operators

// and ending up in the try/catch of the subscribe method which then

// prevents onErrorResumeNext and other similar approaches to error handling

if (e instanceof OnErrorNotImplementedException) {

throw (OnErrorNotImplementedException) e;

}

o.onError(e);

}

}

});

}

/* *********************************************************************************************************

* Observers Below Here

* *********************************************************************************************************

*/

/**

* Mirrors the one Observable in an Iterable of several Observables that first emits an item.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/amb.png">

*

* @param sources

* an Iterable of Observable sources competing to react first

* @return an Observable that emits the same sequence of items as whichever of the source Observables first

* emitted an item

* @see <a href="https://github.com/Netflix/RxJava/wiki/Conditional-and-Boolean-Operators#wiki-amb">RxJava Wiki: amb()</a>

* @see <a href="http://msdn.microsoft.com/en-us/library/hh229115.aspx">MSDN: Observable.Amb</a>

*/

public final static <T> Observable<T> amb(Iterable<? extends Observable<? extends T>> sources) {

return create(OperatorAmb.amb(sources));

}

/**

* Given two Observables, mirrors the one that first emits an item.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/amb.png">

*

* @param o1

* an Observable competing to react first

* @param o2

* an Observable competing to react first

* @return an Observable that emits the same sequence of items as whichever of the source Observables first

* emitted an item

* @see <a href="https://github.com/Netflix/RxJava/wiki/Conditional-and-Boolean-Operators#wiki-amb">RxJava Wiki: amb()</a>

* @see <a href="http://msdn.microsoft.com/en-us/library/hh229733.aspx">MSDN: Observable.Amb</a>

*/

public final static <T> Observable<T> amb(Observable<? extends T> o1, Observable<? extends T> o2) {

return create(OperatorAmb.amb(o1, o2));

}

/**

* Given three Observables, mirrors the one that first emits an item.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/amb.png">

*

* @param o1

* an Observable competing to react first

* @param o2

* an Observable competing to react first

* @param o3

* an Observable competing to react first

* @return an Observable that emits the same sequence of items as whichever of the source Observables first

* emitted an item

* @see <a href="https://github.com/Netflix/RxJava/wiki/Conditional-and-Boolean-Operators#wiki-amb">RxJava Wiki: amb()</a>

* @see <a href="http://msdn.microsoft.com/en-us/library/hh229733.aspx">MSDN: Observable.Amb</a>

*/

public final static <T> Observable<T> amb(Observable<? extends T> o1, Observable<? extends T> o2, Observable<? extends T> o3) {

return create(OperatorAmb.amb(o1, o2, o3));

}

/**

* Given four Observables, mirrors the one that first emits an item.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/amb.png">

*

* @param o1

* an Observable competing to react first

* @param o2

* an Observable competing to react first

* @param o3

* an Observable competing to react first

* @param o4

* an Observable competing to react first

* @return an Observable that emits the same sequence of items as whichever of the source Observables first

* emitted an item

* @see <a href="https://github.com/Netflix/RxJava/wiki/Conditional-and-Boolean-Operators#wiki-amb">RxJava Wiki: amb()</a>

* @see <a href="http://msdn.microsoft.com/en-us/library/hh229733.aspx">MSDN: Observable.Amb</a>

*/

public final static <T> Observable<T> amb(Observable<? extends T> o1, Observable<? extends T> o2, Observable<? extends T> o3, Observable<? extends T> o4) {

return create(OperatorAmb.amb(o1, o2, o3, o4));

}

/**

* Given five Observables, mirrors the one that first emits an item.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/amb.png">

*

* @param o1

* an Observable competing to react first

* @param o2

* an Observable competing to react first

* @param o3

* an Observable competing to react first

* @param o4

* an Observable competing to react first

* @param o5

* an Observable competing to react first

* @return an Observable that emits the same sequence of items as whichever of the source Observables first

* emitted an item

* @see <a href="https://github.com/Netflix/RxJava/wiki/Conditional-and-Boolean-Operators#wiki-amb">RxJava Wiki: amb()</a>

* @see <a href="http://msdn.microsoft.com/en-us/library/hh229733.aspx">MSDN: Observable.Amb</a>

*/

public final static <T> Observable<T> amb(Observable<? extends T> o1, Observable<? extends T> o2, Observable<? extends T> o3, Observable<? extends T> o4, Observable<? extends T> o5) {

return create(OperatorAmb.amb(o1, o2, o3, o4, o5));

}

/**

* Given six Observables, mirrors the one that first emits an item.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/amb.png">

*

* @param o1

* an Observable competing to react first

* @param o2

* an Observable competing to react first

* @param o3

* an Observable competing to react first

* @param o4

* an Observable competing to react first

* @param o5

* an Observable competing to react first

* @param o6

* an Observable competing to react first

* @return an Observable that emits the same sequence of items as whichever of the source Observables first

* emitted an item

* @see <a href="https://github.com/Netflix/RxJava/wiki/Conditional-and-Boolean-Operators#wiki-amb">RxJava Wiki: amb()</a>

* @see <a href="http://msdn.microsoft.com/en-us/library/hh229733.aspx">MSDN: Observable.Amb</a>

*/

public final static <T> Observable<T> amb(Observable<? extends T> o1, Observable<? extends T> o2, Observable<? extends T> o3, Observable<? extends T> o4, Observable<? extends T> o5, Observable<? extends T> o6) {

return create(OperatorAmb.amb(o1, o2, o3, o4, o5, o6));

}

/**

* Given seven Observables, mirrors the one that first emits an item.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/amb.png">

*

* @param o1

* an Observable competing to react first

* @param o2

* an Observable competing to react first

* @param o3

* an Observable competing to react first

* @param o4

* an Observable competing to react first

* @param o5

* an Observable competing to react first

* @param o6

* an Observable competing to react first

* @param o7

* an Observable competing to react first

* @return an Observable that emits the same sequence of items as whichever of the source Observables first

* emitted an item

* @see <a href="https://github.com/Netflix/RxJava/wiki/Conditional-and-Boolean-Operators#wiki-amb">RxJava Wiki: amb()</a>

* @see <a href="http://msdn.microsoft.com/en-us/library/hh229733.aspx">MSDN: Observable.Amb</a>

*/

public final static <T> Observable<T> amb(Observable<? extends T> o1, Observable<? extends T> o2, Observable<? extends T> o3, Observable<? extends T> o4, Observable<? extends T> o5, Observable<? extends T> o6, Observable<? extends T> o7) {

return create(OperatorAmb.amb(o1, o2, o3, o4, o5, o6, o7));

}

/**

* Given eight Observables, mirrors the one that first emits an item.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/amb.png">

*

* @param o1

* an Observable competing to react first

* @param o2

* an Observable competing to react first

* @param o3

* an Observable competing to react first

* @param o4

* an Observable competing to react first

* @param o5

* an Observable competing to react first

* @param o6

* an Observable competing to react first

* @param o7

* an Observable competing to react first

* @param o8

* an observable competing to react first

* @return an Observable that emits the same sequence of items as whichever of the source Observables first

* emitted an item

* @see <a href="https://github.com/Netflix/RxJava/wiki/Conditional-and-Boolean-Operators#wiki-amb">RxJava Wiki: amb()</a>

* @see <a href="http://msdn.microsoft.com/en-us/library/hh229733.aspx">MSDN: Observable.Amb</a>

*/

public final static <T> Observable<T> amb(Observable<? extends T> o1, Observable<? extends T> o2, Observable<? extends T> o3, Observable<? extends T> o4, Observable<? extends T> o5, Observable<? extends T> o6, Observable<? extends T> o7, Observable<? extends T> o8) {

return create(OperatorAmb.amb(o1, o2, o3, o4, o5, o6, o7, o8));

}

/**

* Given nine Observables, mirrors the one that first emits an item.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/amb.png">

*

* @param o1

* an Observable competing to react first

* @param o2

* an Observable competing to react first

* @param o3

* an Observable competing to react first

* @param o4

* an Observable competing to react first

* @param o5

* an Observable competing to react first

* @param o6

* an Observable competing to react first

* @param o7

* an Observable competing to react first

* @param o8

* an Observable competing to react first

* @param o9

* an Observable competing to react first

* @return an Observable that emits the same sequence of items as whichever of the source Observables first

* emitted an item

* @see <a href="https://github.com/Netflix/RxJava/wiki/Conditional-and-Boolean-Operators#wiki-amb">RxJava Wiki: amb()</a>

* @see <a href="http://msdn.microsoft.com/en-us/library/hh229733.aspx">MSDN: Observable.Amb</a>

*/

public final static <T> Observable<T> amb(Observable<? extends T> o1, Observable<? extends T> o2, Observable<? extends T> o3, Observable<? extends T> o4, Observable<? extends T> o5, Observable<? extends T> o6, Observable<? extends T> o7, Observable<? extends T> o8, Observable<? extends T> o9) {

return create(OperatorAmb.amb(o1, o2, o3, o4, o5, o6, o7, o8, o9));

}

/**

* Combines two source Observables by emitting an item that aggregates the latest values of each of the

* source Observables each time an item is received from either of the source Observables, where this

* aggregation is defined by a specified function.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/combineLatest.png">

*

* @param o1

* the first source Observable

* @param o2

* the second source Observable

* @param combineFunction

* the aggregation function used to combine the items emitted by the source Observables

* @return an Observable that emits items that are the result of combining the items emitted by the source

* Observables by means of the given aggregation function

* @see <a href="https://github.com/Netflix/RxJava/wiki/Combining-Observables#wiki-combinelatest">RxJava Wiki: combineLatest()</a>

*/

@SuppressWarnings("unchecked")

public static final <T1, T2, R> Observable<R> combineLatest(Observable<? extends T1> o1, Observable<? extends T2> o2, Func2<? super T1, ? super T2, ? extends R> combineFunction) {

return combineLatest(Arrays.asList(o1, o2), Functions.fromFunc(combineFunction));

}

/**

* Combines three source Observables by emitting an item that aggregates the latest values of each of the

* source Observables each time an item is received from any of the source Observables, where this

* aggregation is defined by a specified function.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/combineLatest.png">

*

* @param o1

* the first source Observable

* @param o2

* the second source Observable

* @param o3

* the third source Observable

* @param combineFunction

* the aggregation function used to combine the items emitted by the source Observables

* @return an Observable that emits items that are the result of combining the items emitted by the source

* Observables by means of the given aggregation function

* @see <a href="https://github.com/Netflix/RxJava/wiki/Combining-Observables#wiki-combinelatest">RxJava Wiki: combineLatest()</a>

*/

@SuppressWarnings("unchecked")

public static final <T1, T2, T3, R> Observable<R> combineLatest(Observable<? extends T1> o1, Observable<? extends T2> o2, Observable<? extends T3> o3, Func3<? super T1, ? super T2, ? super T3, ? extends R> combineFunction) {

return combineLatest(Arrays.asList(o1, o2, o3), Functions.fromFunc(combineFunction));

}

/**

* Combines four source Observables by emitting an item that aggregates the latest values of each of the

* source Observables each time an item is received from any of the source Observables, where this

* aggregation is defined by a specified function.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/combineLatest.png">

*

* @param o1

* the first source Observable

* @param o2

* the second source Observable

* @param o3

* the third source Observable

* @param o4

* the fourth source Observable

* @param combineFunction

* the aggregation function used to combine the items emitted by the source Observables

* @return an Observable that emits items that are the result of combining the items emitted by the source

* Observables by means of the given aggregation function

* @see <a href="https://github.com/Netflix/RxJava/wiki/Combining-Observables#wiki-combinelatest">RxJava Wiki: combineLatest()</a>

*/

@SuppressWarnings("unchecked")

public static final <T1, T2, T3, T4, R> Observable<R> combineLatest(Observable<? extends T1> o1, Observable<? extends T2> o2, Observable<? extends T3> o3, Observable<? extends T4> o4,

Func4<? super T1, ? super T2, ? super T3, ? super T4, ? extends R> combineFunction) {

return combineLatest(Arrays.asList(o1, o2, o3, o4), Functions.fromFunc(combineFunction));

}

/**

* Combines five source Observables by emitting an item that aggregates the latest values of each of the

* source Observables each time an item is received from any of the source Observables, where this

* aggregation is defined by a specified function.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/combineLatest.png">

*

* @param o1

* the first source Observable

* @param o2

* the second source Observable

* @param o3

* the third source Observable

* @param o4

* the fourth source Observable

* @param o5

* the fifth source Observable

* @param combineFunction

* the aggregation function used to combine the items emitted by the source Observables

* @return an Observable that emits items that are the result of combining the items emitted by the source

* Observables by means of the given aggregation function

* @see <a href="https://github.com/Netflix/RxJava/wiki/Combining-Observables#wiki-combinelatest">RxJava Wiki: combineLatest()</a>

*/

@SuppressWarnings("unchecked")

public static final <T1, T2, T3, T4, T5, R> Observable<R> combineLatest(Observable<? extends T1> o1, Observable<? extends T2> o2, Observable<? extends T3> o3, Observable<? extends T4> o4, Observable<? extends T5> o5,

Func5<? super T1, ? super T2, ? super T3, ? super T4, ? super T5, ? extends R> combineFunction) {

return combineLatest(Arrays.asList(o1, o2, o3, o4, o5), Functions.fromFunc(combineFunction));

}

/**

* Combines six source Observables by emitting an item that aggregates the latest values of each of the

* source Observables each time an item is received from any of the source Observables, where this

* aggregation is defined by a specified function.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/combineLatest.png">

*

* @param o1

* the first source Observable

* @param o2

* the second source Observable

* @param o3

* the third source Observable

* @param o4

* the fourth source Observable

* @param o5

* the fifth source Observable

* @param o6

* the sixth source Observable

* @param combineFunction

* the aggregation function used to combine the items emitted by the source Observables

* @return an Observable that emits items that are the result of combining the items emitted by the source

* Observables by means of the given aggregation function

* @see <a href="https://github.com/Netflix/RxJava/wiki/Combining-Observables#wiki-combinelatest">RxJava Wiki: combineLatest()</a>

*/

@SuppressWarnings("unchecked")

public static final <T1, T2, T3, T4, T5, T6, R> Observable<R> combineLatest(Observable<? extends T1> o1, Observable<? extends T2> o2, Observable<? extends T3> o3, Observable<? extends T4> o4, Observable<? extends T5> o5, Observable<? extends T6> o6,

Func6<? super T1, ? super T2, ? super T3, ? super T4, ? super T5, ? super T6, ? extends R> combineFunction) {

return combineLatest(Arrays.asList(o1, o2, o3, o4, o5, o6), Functions.fromFunc(combineFunction));

}

/**

* Combines seven source Observables by emitting an item that aggregates the latest values of each of the

* source Observables each time an item is received from any of the source Observables, where this

* aggregation is defined by a specified function.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/combineLatest.png">

*

* @param o1

* the first source Observable

* @param o2

* the second source Observable

* @param o3

* the third source Observable

* @param o4

* the fourth source Observable

* @param o5

* the fifth source Observable

* @param o6

* the sixth source Observable

* @param o7

* the seventh source Observable

* @param combineFunction

* the aggregation function used to combine the items emitted by the source Observables

* @return an Observable that emits items that are the result of combining the items emitted by the source

* Observables by means of the given aggregation function

* @see <a href="https://github.com/Netflix/RxJava/wiki/Combining-Observables#wiki-combinelatest">RxJava Wiki: combineLatest()</a>

*/

@SuppressWarnings("unchecked")

public static final <T1, T2, T3, T4, T5, T6, T7, R> Observable<R> combineLatest(Observable<? extends T1> o1, Observable<? extends T2> o2, Observable<? extends T3> o3, Observable<? extends T4> o4, Observable<? extends T5> o5, Observable<? extends T6> o6, Observable<? extends T7> o7,

Func7<? super T1, ? super T2, ? super T3, ? super T4, ? super T5, ? super T6, ? super T7, ? extends R> combineFunction) {

return combineLatest(Arrays.asList(o1, o2, o3, o4, o5, o6, o7), Functions.fromFunc(combineFunction));

}

/**

* Combines eight source Observables by emitting an item that aggregates the latest values of each of the

* source Observables each time an item is received from any of the source Observables, where this

* aggregation is defined by a specified function.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/combineLatest.png">

*

* @param o1

* the first source Observable

* @param o2

* the second source Observable

* @param o3

* the third source Observable

* @param o4

* the fourth source Observable

* @param o5

* the fifth source Observable

* @param o6

* the sixth source Observable

* @param o7

* the seventh source Observable

* @param o8

* the eighth source Observable

* @param combineFunction

* the aggregation function used to combine the items emitted by the source Observables

* @return an Observable that emits items that are the result of combining the items emitted by the source

* Observables by means of the given aggregation function

* @see <a href="https://github.com/Netflix/RxJava/wiki/Combining-Observables#wiki-combinelatest">RxJava Wiki: combineLatest()</a>

*/

@SuppressWarnings("unchecked")

public static final <T1, T2, T3, T4, T5, T6, T7, T8, R> Observable<R> combineLatest(Observable<? extends T1> o1, Observable<? extends T2> o2, Observable<? extends T3> o3, Observable<? extends T4> o4, Observable<? extends T5> o5, Observable<? extends T6> o6, Observable<? extends T7> o7, Observable<? extends T8> o8,

Func8<? super T1, ? super T2, ? super T3, ? super T4, ? super T5, ? super T6, ? super T7, ? super T8, ? extends R> combineFunction) {

return combineLatest(Arrays.asList(o1, o2, o3, o4, o5, o6, o7, o8), Functions.fromFunc(combineFunction));

}

/**

* Combines nine source Observables by emitting an item that aggregates the latest values of each of the

* source Observables each time an item is received from any of the source Observables, where this

* aggregation is defined by a specified function.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/combineLatest.png">

*

* @param o1

* the first source Observable

* @param o2

* the second source Observable

* @param o3

* the third source Observable

* @param o4

* the fourth source Observable

* @param o5

* the fifth source Observable

* @param o6

* the sixth source Observable

* @param o7

* the seventh source Observable

* @param o8

* the eighth source Observable

* @param o9

* the ninth source Observable

* @param combineFunction

* the aggregation function used to combine the items emitted by the source Observables

* @return an Observable that emits items that are the result of combining the items emitted by the source

* Observables by means of the given aggregation function

* @see <a href="https://github.com/Netflix/RxJava/wiki/Combining-Observables#wiki-combinelatest">RxJava Wiki: combineLatest()</a>

*/

@SuppressWarnings("unchecked")

public static final <T1, T2, T3, T4, T5, T6, T7, T8, T9, R> Observable<R> combineLatest(Observable<? extends T1> o1, Observable<? extends T2> o2, Observable<? extends T3> o3, Observable<? extends T4> o4, Observable<? extends T5> o5, Observable<? extends T6> o6, Observable<? extends T7> o7, Observable<? extends T8> o8,

Observable<? extends T9> o9,

Func9<? super T1, ? super T2, ? super T3, ? super T4, ? super T5, ? super T6, ? super T7, ? super T8, ? super T9, ? extends R> combineFunction) {

return combineLatest(Arrays.asList(o1, o2, o3, o4, o5, o6, o7, o8, o9), Functions.fromFunc(combineFunction));

}

/**

* Combines a list of source Observables by emitting an item that aggregates the latest values of each of

* the source Observables each time an item is received from any of the source Observables, where this

* aggregation is defined by a specified function.

*

* @param <T>

* the common base type of source values

* @param <R>

* the result type

* @param sources

* the list of source Observables

* @param combineFunction

* the aggregation function used to combine the items emitted by the source Observables

* @return an Observable that emits items that are the result of combining the items emitted by the source

* Observables by means of the given aggregation function

* @see <a href="https://github.com/Netflix/RxJava/wiki/Combining-Observables#wiki-combinelatest">RxJava Wiki: combineLatest()</a>

*/

public static final <T, R> Observable<R> combineLatest(List<? extends Observable<? extends T>> sources, FuncN<? extends R> combineFunction) {

return create(new OperatorCombineLatest<T, R>(sources, combineFunction));

}

/**

* Returns an Observable that emits the items emitted by each of the Observables emitted by the source

* Observable, one after the other, without interleaving them.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/concat.png">

*

* @param observables

* an Observable that emits Observables

* @return an Observable that emits items all of the items emitted by the Observables emitted by

* {@code observables}, one after the other, without interleaving them

* @see <a href="https://github.com/Netflix/RxJava/wiki/Mathematical-and-Aggregate-Operators#wiki-concat">RxJava Wiki: concat()</a>

* @see <a href="http://msdn.microsoft.com/en-us/library/system.reactive.linq.observable.concat.aspx">MSDN: Observable.Concat</a>

*/

public final static <T> Observable<T> concat(Observable<? extends Observable<? extends T>> observables) {

return observables.lift(new OperatorConcat<T>());

}

/**

* Returns an Observable that emits the items emitted by two Observables, one after the other, without

* interleaving them.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/concat.png">

*

* @param t1

* an Observable to be concatenated

* @param t2

* an Observable to be concatenated

* @return an Observable that emits items emitted by the two source Observables, one after the other,

* without interleaving them

* @see <a href="https://github.com/Netflix/RxJava/wiki/Mathematical-and-Aggregate-Operators#wiki-concat">RxJava Wiki: concat()</a>

* @see <a href="http://msdn.microsoft.com/en-us/library/system.reactive.linq.observable.concat.aspx">MSDN: Observable.Concat</a>

*/

public final static <T> Observable<T> concat(Observable<? extends T> t1, Observable<? extends T> t2) {

return concat(from(t1, t2));

}

/**

* Returns an Observable that emits the items emitted by three Observables, one after the other, without

* interleaving them.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/concat.png">

*

* @param t1

* an Observable to be concatenated

* @param t2

* an Observable to be concatenated

* @param t3

* an Observable to be concatenated

* @return an Observable that emits items emitted by the three source Observables, one after the other,

* without interleaving them

* @see <a href="https://github.com/Netflix/RxJava/wiki/Mathematical-and-Aggregate-Operators#wiki-concat">RxJava Wiki: concat()</a>

* @see <a href="http://msdn.microsoft.com/en-us/library/system.reactive.linq.observable.concat.aspx">MSDN: Observable.Concat</a>

*/

public final static <T> Observable<T> concat(Observable<? extends T> t1, Observable<? extends T> t2, Observable<? extends T> t3) {

return concat(from(t1, t2, t3));

}

/**

* Returns an Observable that emits the items emitted by four Observables, one after the other, without

* interleaving them.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/concat.png">

*

* @param t1

* an Observable to be concatenated

* @param t2

* an Observable to be concatenated

* @param t3

* an Observable to be concatenated

* @param t4

* an Observable to be concatenated

* @return an Observable that emits items emitted by the four source Observables, one after the other,

* without interleaving them

* @see <a href="https://github.com/Netflix/RxJava/wiki/Mathematical-and-Aggregate-Operators#wiki-concat">RxJava Wiki: concat()</a>

* @see <a href="http://msdn.microsoft.com/en-us/library/system.reactive.linq.observable.concat.aspx">MSDN: Observable.Concat</a>

*/

public final static <T> Observable<T> concat(Observable<? extends T> t1, Observable<? extends T> t2, Observable<? extends T> t3, Observable<? extends T> t4) {

return concat(from(t1, t2, t3, t4));

}

/**

* Returns an Observable that emits the items emitted by five Observables, one after the other, without

* interleaving them.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/concat.png">

*

* @param t1

* an Observable to be concatenated

* @param t2

* an Observable to be concatenated

* @param t3

* an Observable to be concatenated

* @param t4

* an Observable to be concatenated

* @param t5

* an Observable to be concatenated

* @return an Observable that emits items emitted by the five source Observables, one after the other,

* without interleaving them

* @see <a href="https://github.com/Netflix/RxJava/wiki/Mathematical-and-Aggregate-Operators#wiki-concat">RxJava Wiki: concat()</a>

* @see <a href="http://msdn.microsoft.com/en-us/library/system.reactive.linq.observable.concat.aspx">MSDN: Observable.Concat</a>

*/

public final static <T> Observable<T> concat(Observable<? extends T> t1, Observable<? extends T> t2, Observable<? extends T> t3, Observable<? extends T> t4, Observable<? extends T> t5) {

return concat(from(t1, t2, t3, t4, t5));

}

/**

* Returns an Observable that emits the items emitted by six Observables, one after the other, without

* interleaving them.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/concat.png">

*

* @param t1

* an Observable to be concatenated

* @param t2

* an Observable to be concatenated

* @param t3

* an Observable to be concatenated

* @param t4

* an Observable to be concatenated

* @param t5

* an Observable to be concatenated

* @param t6

* an Observable to be concatenated

* @return an Observable that emits items emitted by the six source Observables, one after the other,

* without interleaving them

* @see <a href="https://github.com/Netflix/RxJava/wiki/Mathematical-and-Aggregate-Operators#wiki-concat">RxJava Wiki: concat()</a>

* @see <a href="http://msdn.microsoft.com/en-us/library/system.reactive.linq.observable.concat.aspx">MSDN: Observable.Concat</a>

*/

public final static <T> Observable<T> concat(Observable<? extends T> t1, Observable<? extends T> t2, Observable<? extends T> t3, Observable<? extends T> t4, Observable<? extends T> t5, Observable<? extends T> t6) {

return concat(from(t1, t2, t3, t4, t5, t6));

}

/**

* Returns an Observable that emits the items emitted by seven Observables, one after the other, without

* interleaving them.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/concat.png">

*

* @param t1

* an Observable to be concatenated

* @param t2

* an Observable to be concatenated

* @param t3

* an Observable to be concatenated

* @param t4

* an Observable to be concatenated

* @param t5

* an Observable to be concatenated

* @param t6

* an Observable to be concatenated

* @param t7

* an Observable to be concatenated

* @return an Observable that emits items emitted by the seven source Observables, one after the other,

* without interleaving them

* @see <a href="https://github.com/Netflix/RxJava/wiki/Mathematical-and-Aggregate-Operators#wiki-concat">RxJava Wiki: concat()</a>

* @see <a href="http://msdn.microsoft.com/en-us/library/system.reactive.linq.observable.concat.aspx">MSDN: Observable.Concat</a>

*/

public final static <T> Observable<T> concat(Observable<? extends T> t1, Observable<? extends T> t2, Observable<? extends T> t3, Observable<? extends T> t4, Observable<? extends T> t5, Observable<? extends T> t6, Observable<? extends T> t7) {

return concat(from(t1, t2, t3, t4, t5, t6, t7));

}

/**

* Returns an Observable that emits the items emitted by eight Observables, one after the other, without

* interleaving them.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/concat.png">

*

* @param t1

* an Observable to be concatenated

* @param t2

* an Observable to be concatenated

* @param t3

* an Observable to be concatenated

* @param t4

* an Observable to be concatenated

* @param t5

* an Observable to be concatenated

* @param t6

* an Observable to be concatenated

* @param t7

* an Observable to be concatenated

* @param t8

* an Observable to be concatenated

* @return an Observable that emits items emitted by the eight source Observables, one after the other,

* without interleaving them

* @see <a href="https://github.com/Netflix/RxJava/wiki/Mathematical-and-Aggregate-Operators#wiki-concat">RxJava Wiki: concat()</a>

* @see <a href="http://msdn.microsoft.com/en-us/library/system.reactive.linq.observable.concat.aspx">MSDN: Observable.Concat</a>

*/

public final static <T> Observable<T> concat(Observable<? extends T> t1, Observable<? extends T> t2, Observable<? extends T> t3, Observable<? extends T> t4, Observable<? extends T> t5, Observable<? extends T> t6, Observable<? extends T> t7, Observable<? extends T> t8) {

return concat(from(t1, t2, t3, t4, t5, t6, t7, t8));

}

/**

* Returns an Observable that emits the items emitted by nine Observables, one after the other, without

* interleaving them.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/concat.png">

*

* @param t1

* an Observable to be concatenated

* @param t2

* an Observable to be concatenated

* @param t3

* an Observable to be concatenated

* @param t4

* an Observable to be concatenated

* @param t5

* an Observable to be concatenated

* @param t6

* an Observable to be concatenated

* @param t7

* an Observable to be concatenated

* @param t8

* an Observable to be concatenated

* @param t9

* an Observable to be concatenated

* @return an Observable that emits items emitted by the nine source Observables, one after the other,

* without interleaving them

* @see <a href="https://github.com/Netflix/RxJava/wiki/Mathematical-and-Aggregate-Operators#wiki-concat">RxJava Wiki: concat()</a>

* @see <a href="http://msdn.microsoft.com/en-us/library/system.reactive.linq.observable.concat.aspx">MSDN: Observable.Concat</a>

*/

public final static <T> Observable<T> concat(Observable<? extends T> t1, Observable<? extends T> t2, Observable<? extends T> t3, Observable<? extends T> t4, Observable<? extends T> t5, Observable<? extends T> t6, Observable<? extends T> t7, Observable<? extends T> t8, Observable<? extends T> t9) {

return concat(from(t1, t2, t3, t4, t5, t6, t7, t8, t9));

}

/**

* Returns an Observable that calls an Observable factory to create an Observable for each new Observer

* that subscribes. That is, for each subscriber, the actual Observable that subscriber observes is

* determined by the factory function.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/defer.png">

* <p>

* The defer Observer allows you to defer or delay emitting items from an Observable until such time as an

* Observer subscribes to the Observable. This allows an {@link Observer} to easily obtain updates or a

* refreshed version of the sequence.

*

* @param observableFactory

* the Observable factory function to invoke for each {@link Observer} that subscribes to the

* resulting Observable

* @param <T>

* the type of the items emitted by the Observable

* @return an Observable whose {@link Observer}s' subscriptions trigger an invocation of the given

* Observable factory function

* @see <a href="https://github.com/Netflix/RxJava/wiki/Creating-Observables#wiki-defer">RxJava Wiki: defer()</a>

*/

public final static <T> Observable<T> defer(Func0<? extends Observable<? extends T>> observableFactory) {

return create(new OperatorDefer<T>(observableFactory));

}

/**

* Returns an Observable that emits no items to the {@link Observer} and immediately invokes its

* {@link Observer#onCompleted onCompleted} method.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/empty.png">

*

* @param <T>

* the type of the items (ostensibly) emitted by the Observable

* @return an Observable that emits no items to the {@link Observer} but immediately invokes the

* {@link Observer}'s {@link Observer#onCompleted() onCompleted} method

* @see <a href="https://github.com/Netflix/RxJava/wiki/Creating-Observables#wiki-empty-error-and-never">RxJava Wiki: empty()</a>

* @see <a href="http://msdn.microsoft.com/en-us/library/hh229670.aspx">MSDN: Observable.Empty</a>

*/

public final static <T> Observable<T> empty() {

return from(new ArrayList<T>());

}

/**

* Returns an Observable that emits no items to the {@link Observer} and immediately invokes its

* {@link Observer#onCompleted onCompleted} method on the specified Scheduler.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/empty.s.png">

*

* @param scheduler

* the Scheduler to use to call the {@link Observer#onCompleted onCompleted} method

* @param <T>

* the type of the items (ostensibly) emitted by the Observable

* @return an Observable that emits no items to the {@link Observer} but immediately invokes the

* {@link Observer}'s {@link Observer#onCompleted() onCompleted} method with the specified

* {@code scheduler}

* @see <a href="https://github.com/Netflix/RxJava/wiki/Creating-Observables#wiki-empty-error-and-never">RxJava Wiki: empty()</a>

* @see <a href="http://msdn.microsoft.com/en-us/library/hh229066.aspx">MSDN: Observable.Empty Method (IScheduler)</a>

*/

public final static <T> Observable<T> empty(Scheduler scheduler) {

return Observable.<T> empty().subscribeOn(scheduler);

}

/**

* Returns an Observable that invokes an {@link Observer}'s {@link Observer#onError onError} method when the

* Observer subscribes to it.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/error.png">

*

* @param exception

* the particular Throwable to pass to {@link Observer#onError onError}

* @param <T>

* the type of the items (ostensibly) emitted by the Observable

* @return an Observable that invokes the {@link Observer}'s {@link Observer#onError onError} method when

* the Observer subscribes to it

* @see <a href="https://github.com/Netflix/RxJava/wiki/Creating-Observables#wiki-empty-error-and-never">RxJava Wiki: error()</a>

* @see <a href="http://msdn.microsoft.com/en-us/library/hh244299.aspx">MSDN: Observable.Throw</a>

*/

public final static <T> Observable<T> error(Throwable exception) {

return new ThrowObservable<T>(exception);

}

/**

* Returns an Observable that invokes an {@link Observer}'s {@link Observer#onError onError} method on the

* specified Scheduler.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/error.s.png">

*

* @param exception

* the particular Throwable to pass to {@link Observer#onError onError}

* @param scheduler

* the Scheduler on which to call {@link Observer#onError onError}

* @param <T>

* the type of the items (ostensibly) emitted by the Observable

* @return an Observable that invokes the {@link Observer}'s {@link Observer#onError onError} method, on

* the specified Scheduler

* @see <a href="https://github.com/Netflix/RxJava/wiki/Creating-Observables#wiki-empty-error-and-never">RxJava Wiki: error()</a>

* @see <a href="http://msdn.microsoft.com/en-us/library/hh211711.aspx">MSDN: Observable.Throw</a>

*/

public final static <T> Observable<T> error(Throwable exception, Scheduler scheduler) {

return Observable.<T> error(exception).subscribeOn(scheduler);

}

/**

* Converts a {@link Future} into an Observable.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/from.Future.png">

* <p>

* You can convert any object that supports the {@link Future} interface into an Observable that emits the

* return value of the {@link Future#get} method of that object, by passing the object into the {@code from}

* method.

* <p>

* <em>Important note:</em> This Observable is blocking; you cannot unsubscribe from it.

*

* @param future

* the source {@link Future}

* @param <T>

* the type of object that the {@link Future} returns, and also the type of item to be emitted by

* the resulting Observable

* @return an Observable that emits the item from the source {@link Future}

* @see <a href="https://github.com/Netflix/RxJava/wiki/Creating-Observables#wiki-from">RxJava Wiki: from()</a>

*/

public final static <T> Observable<T> from(Future<? extends T> future) {

return create(OperatorToObservableFuture.toObservableFuture(future));

}

/**

* Converts a {@link Future} into an Observable, with a timeout on the Future.

* <p>

* <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/from.Future.png">