/**

* 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 java.util.*;

import java.util.concurrent.*;

import rx.annotations.*;

import rx.exceptions.*;

import rx.functions.*;

import rx.internal.operators.*;

import rx.internal.producers.SingleProducer;

import rx.internal.util.*;

import rx.observables.*;

import rx.observers.SafeSubscriber;

import rx.plugins.*;

import rx.schedulers.*;

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" height="301" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/legend.png" alt="">

* <p>

* For more information see the <a href="http://reactivex.io/documentation/observable.html">ReactiveX

* documentation</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" height="200" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/create.png" alt="">

* <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.

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code create} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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="http://reactivex.io/documentation/operators/create.html">ReactiveX operators documentation: Create</a>

*/

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

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

}

/**

* Invoked when Observable.subscribe is called.

*/

public 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

}

/**

* 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()

* }

* <p>

* If the operator you are creating is designed to act on the individual items emitted by a source

* Observable, use {@code lift}. If your operator is designed to transform the source Observable as a whole

* (for instance, by applying a particular set of existing RxJava operators to it) use {@link #compose}.

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code lift} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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

* @see <a href="https://github.com/ReactiveX/RxJava/wiki/Implementing-Your-Own-Operators">RxJava wiki: Implementing Your Own Operators</a>

*/

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 {

Subscriber<? super T> st = hook.onLift(lift).call(o);

try {

// new Subscriber created and being subscribed with so 'onStart' it

st.onStart();

onSubscribe.call(st);

} 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;

}

st.onError(e);

}

} catch (Throwable e) {

if (e instanceof OnErrorNotImplementedException) {

throw (OnErrorNotImplementedException) e;

}

// if the lift function failed all we can do is pass the error to the final Subscriber

// as we don't have the operator available to us

o.onError(e);

}

}

});

}

/**

* Transform an Observable by applying a particular Transformer function to it.

* <p>

* This method operates on the Observable itself whereas {@link #lift} operates on the Observable's

* Subscribers or Observers.

* <p>

* If the operator you are creating is designed to act on the individual items emitted by a source

* Observable, use {@link #lift}. If your operator is designed to transform the source Observable as a whole

* (for instance, by applying a particular set of existing RxJava operators to it) use {@code compose}.

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code compose} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @param transformer implements the function that transforms the source Observable

* @return the source Observable, transformed by the transformer function

* @see <a href="https://github.com/ReactiveX/RxJava/wiki/Implementing-Your-Own-Operators">RxJava wiki: Implementing Your Own Operators</a>

*/

@SuppressWarnings("unchecked")

public <R> Observable<R> compose(Transformer<? super T, ? extends R> transformer) {

return ((Transformer<T, R>) transformer).call(this);

}

/**

* Transformer function used by {@link #compose}.

* @warn more complete description needed

*/

public interface Transformer<T, R> extends Func1<Observable<T>, Observable<R>> {

// cover for generics insanity

}

/**

* Returns a Single that emits the single item emitted by the source Observable, if that Observable

* emits only a single item. If the source Observable emits more than one item or no items, notify of an

* {@code IllegalArgumentException} or {@code NoSuchElementException} respectively.

* <p>

* <img width="640" height="295" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/toSingle.png" alt="">

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code toSingle} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @return a Single that emits the single item emitted by the source Observable

* @throws IllegalArgumentException

* if the source observable emits more than one item

* @throws NoSuchElementException

* if the source observable emits no items

* @see <a href="http://reactivex.io/documentation/single.html">ReactiveX documentation: Single</a>

* @since (if this graduates from Experimental/Beta to supported, replace this parenthetical with the release number)

*/

@Experimental

public Single<T> toSingle() {

return new Single<T>(OnSubscribeSingle.create(this));

}

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

* Operators Below Here

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

*/

/**

* Mirrors the one Observable in an Iterable of several Observables that first either emits an item or sends

* a termination notification.

* <p>

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

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code amb} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @param sources

* an Iterable of Observable sources competing to react first

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

* emitted an item or sent a termination notification

* @see <a href="http://reactivex.io/documentation/operators/amb.html">ReactiveX operators documentation: Amb</a>

*/

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

return create(OnSubscribeAmb.amb(sources));

}

/**

* Given two Observables, mirrors the one that first either emits an item or sends a termination

* notification.

* <p>

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

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code amb} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @param o1

* an Observable competing to react first

* @param o2

* an Observable competing to react first

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

* emitted an item or sent a termination notification

* @see <a href="http://reactivex.io/documentation/operators/amb.html">ReactiveX operators documentation: Amb</a>

*/

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

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

}

/**

* Given three Observables, mirrors the one that first either emits an item or sends a termination

* notification.

* <p>

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

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code amb} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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 as whichever of the source Observables first

* emitted an item or sent a termination notification

* @see <a href="http://reactivex.io/documentation/operators/amb.html">ReactiveX operators documentation: Amb</a>

*/

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

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

}

/**

* Given four Observables, mirrors the one that first either emits an item or sends a termination

* notification.

* <p>

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

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code amb} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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 as whichever of the source Observables first

* emitted an item or sent a termination notification

* @see <a href="http://reactivex.io/documentation/operators/amb.html">ReactiveX operators documentation: 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(OnSubscribeAmb.amb(o1, o2, o3, o4));

}

/**

* Given five Observables, mirrors the one that first either emits an item or sends a termination

* notification.

* <p>

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

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code amb} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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 as whichever of the source Observables first

* emitted an item or sent a termination notification

* @see <a href="http://reactivex.io/documentation/operators/amb.html">ReactiveX operators documentation: 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(OnSubscribeAmb.amb(o1, o2, o3, o4, o5));

}

/**

* Given six Observables, mirrors the one that first either emits an item or sends a termination

* notification.

* <p>

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

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code amb} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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 as whichever of the source Observables first

* emitted an item or sent a termination notification

* @see <a href="http://reactivex.io/documentation/operators/amb.html">ReactiveX operators documentation: 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(OnSubscribeAmb.amb(o1, o2, o3, o4, o5, o6));

}

/**

* Given seven Observables, mirrors the one that first either emits an item or sends a termination

* notification.

* <p>

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

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code amb} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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 as whichever of the source Observables first

* emitted an item or sent a termination notification

* @see <a href="http://reactivex.io/documentation/operators/amb.html">ReactiveX operators documentation: 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(OnSubscribeAmb.amb(o1, o2, o3, o4, o5, o6, o7));

}

/**

* Given eight Observables, mirrors the one that first either emits an item or sends a termination

* notification.

* <p>

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

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code amb} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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 as whichever of the source Observables first

* emitted an item or sent a termination notification

* @see <a href="http://reactivex.io/documentation/operators/amb.html">ReactiveX operators documentation: 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(OnSubscribeAmb.amb(o1, o2, o3, o4, o5, o6, o7, o8));

}

/**

* Given nine Observables, mirrors the one that first either emits an item or sends a termination

* notification.

* <p>

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

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code amb} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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 as whichever of the source Observables first

* emitted an item or sent a termination notification

* @see <a href="http://reactivex.io/documentation/operators/amb.html">ReactiveX operators documentation: 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(OnSubscribeAmb.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" height="380" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/combineLatest.png" alt="">

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code combineLatest} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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="http://reactivex.io/documentation/operators/combinelatest.html">ReactiveX operators documentation: 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" height="380" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/combineLatest.png" alt="">

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code combineLatest} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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="http://reactivex.io/documentation/operators/combinelatest.html">ReactiveX operators documentation: 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" height="380" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/combineLatest.png" alt="">

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code combineLatest} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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="http://reactivex.io/documentation/operators/combinelatest.html">ReactiveX operators documentation: 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" height="380" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/combineLatest.png" alt="">

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code combineLatest} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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="http://reactivex.io/documentation/operators/combinelatest.html">ReactiveX operators documentation: 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" height="380" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/combineLatest.png" alt="">

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code combineLatest} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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="http://reactivex.io/documentation/operators/combinelatest.html">ReactiveX operators documentation: 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" height="380" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/combineLatest.png" alt="">

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code combineLatest} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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="http://reactivex.io/documentation/operators/combinelatest.html">ReactiveX operators documentation: 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" height="380" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/combineLatest.png" alt="">

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code combineLatest} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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="http://reactivex.io/documentation/operators/combinelatest.html">ReactiveX operators documentation: 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" height="380" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/combineLatest.png" alt="">

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code combineLatest} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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="http://reactivex.io/documentation/operators/combinelatest.html">ReactiveX operators documentation: 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.

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code combineLatest} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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="http://reactivex.io/documentation/operators/combinelatest.html">ReactiveX operators documentation: CombineLatest</a>

*/

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

return create(new OnSubscribeCombineLatest<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" height="380" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/concat.png" alt="">

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code concat} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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="http://reactivex.io/documentation/operators/concat.html">ReactiveX operators documentation: Concat</a>

*/

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

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

}

/**

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

* interleaving them.

* <p>

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

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code concat} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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="http://reactivex.io/documentation/operators/concat.html">ReactiveX operators documentation: Concat</a>

*/

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

return concat(just(t1, t2));

}

/**

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

* interleaving them.

* <p>

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

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code concat} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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="http://reactivex.io/documentation/operators/concat.html">ReactiveX operators documentation: Concat</a>

*/

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

return concat(just(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" height="380" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/concat.png" alt="">

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code concat} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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="http://reactivex.io/documentation/operators/concat.html">ReactiveX operators documentation: 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(just(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" height="380" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/concat.png" alt="">

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code concat} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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="http://reactivex.io/documentation/operators/concat.html">ReactiveX operators documentation: 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(just(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" height="380" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/concat.png" alt="">

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code concat} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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="http://reactivex.io/documentation/operators/concat.html">ReactiveX operators documentation: 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(just(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" height="380" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/concat.png" alt="">

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code concat} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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="http://reactivex.io/documentation/operators/concat.html">ReactiveX operators documentation: 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(just(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" height="380" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/concat.png" alt="">

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code concat} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*

* @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="http://reactivex.io/documentation/operators/concat.html">ReactiveX operators documentation: 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(just(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" height="380" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/concat.png" alt="">

* <dl>

* <dt><b>Scheduler:</b></dt>

* <dd>{@code concat} does not operate by default on a particular {@link Scheduler}.</dd>

* </dl>

*