123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144 |
- import { IScheduler } from '../Scheduler';
- import { Observable } from '../Observable';
- import { Subscriber } from '../Subscriber';
- import { Subscription } from '../Subscription';
- export declare type ConditionFunc<S> = (state: S) => boolean;
- export declare type IterateFunc<S> = (state: S) => S;
- export declare type ResultFunc<S, T> = (state: S) => T;
- export interface GenerateBaseOptions<S> {
- /**
- * Initial state.
- */
- initialState: S;
- /**
- * Condition function that accepts state and returns boolean.
- * When it returns false, the generator stops.
- * If not specified, a generator never stops.
- */
- condition?: ConditionFunc<S>;
- /**
- * Iterate function that accepts state and returns new state.
- */
- iterate: IterateFunc<S>;
- /**
- * IScheduler to use for generation process.
- * By default, a generator starts immediately.
- */
- scheduler?: IScheduler;
- }
- export interface GenerateOptions<T, S> extends GenerateBaseOptions<S> {
- /**
- * Result selection function that accepts state and returns a value to emit.
- */
- resultSelector: ResultFunc<S, T>;
- }
- /**
- * We need this JSDoc comment for affecting ESDoc.
- * @extends {Ignored}
- * @hide true
- */
- export declare class GenerateObservable<T, S> extends Observable<T> {
- private initialState;
- private condition;
- private iterate;
- private resultSelector;
- private scheduler;
- constructor(initialState: S, condition: ConditionFunc<S>, iterate: IterateFunc<S>, resultSelector: ResultFunc<S, T>, scheduler?: IScheduler);
- /**
- * Generates an observable sequence by running a state-driven loop
- * producing the sequence's elements, using the specified scheduler
- * to send out observer messages.
- *
- * <img src="./img/generate.png" width="100%">
- *
- * @example <caption>Produces sequence of 0, 1, 2, ... 9, then completes.</caption>
- * var res = Rx.Observable.generate(0, x => x < 10, x => x + 1, x => x);
- *
- * @example <caption>Using asap scheduler, produces sequence of 2, 3, 5, then completes.</caption>
- * var res = Rx.Observable.generate(1, x => x < 5, x => x * 2, x => x + 1, Rx.Scheduler.asap);
- *
- * @see {@link from}
- * @see {@link create}
- *
- * @param {S} initialState Initial state.
- * @param {function (state: S): boolean} condition Condition to terminate generation (upon returning false).
- * @param {function (state: S): S} iterate Iteration step function.
- * @param {function (state: S): T} resultSelector Selector function for results produced in the sequence.
- * @param {Scheduler} [scheduler] A {@link IScheduler} on which to run the generator loop. If not provided, defaults to emit immediately.
- * @returns {Observable<T>} The generated sequence.
- */
- static create<T, S>(initialState: S, condition: ConditionFunc<S>, iterate: IterateFunc<S>, resultSelector: ResultFunc<S, T>, scheduler?: IScheduler): Observable<T>;
- /**
- * Generates an observable sequence by running a state-driven loop
- * producing the sequence's elements, using the specified scheduler
- * to send out observer messages.
- * The overload uses state as an emitted value.
- *
- * <img src="./img/generate.png" width="100%">
- *
- * @example <caption>Produces sequence of 0, 1, 2, ... 9, then completes.</caption>
- * var res = Rx.Observable.generate(0, x => x < 10, x => x + 1);
- *
- * @example <caption>Using asap scheduler, produces sequence of 1, 2, 4, then completes.</caption>
- * var res = Rx.Observable.generate(1, x => x < 5, x => x * 2, Rx.Scheduler.asap);
- *
- * @see {@link from}
- * @see {@link create}
- *
- * @param {S} initialState Initial state.
- * @param {function (state: S): boolean} condition Condition to terminate generation (upon returning false).
- * @param {function (state: S): S} iterate Iteration step function.
- * @param {Scheduler} [scheduler] A {@link IScheduler} on which to run the generator loop. If not provided, defaults to emit immediately.
- * @returns {Observable<S>} The generated sequence.
- */
- static create<S>(initialState: S, condition: ConditionFunc<S>, iterate: IterateFunc<S>, scheduler?: IScheduler): Observable<S>;
- /**
- * Generates an observable sequence by running a state-driven loop
- * producing the sequence's elements, using the specified scheduler
- * to send out observer messages.
- * The overload accepts options object that might contain initial state, iterate,
- * condition and scheduler.
- *
- * <img src="./img/generate.png" width="100%">
- *
- * @example <caption>Produces sequence of 0, 1, 2, ... 9, then completes.</caption>
- * var res = Rx.Observable.generate({
- * initialState: 0,
- * condition: x => x < 10,
- * iterate: x => x + 1
- * });
- *
- * @see {@link from}
- * @see {@link create}
- *
- * @param {GenerateBaseOptions<S>} options Object that must contain initialState, iterate and might contain condition and scheduler.
- * @returns {Observable<S>} The generated sequence.
- */
- static create<S>(options: GenerateBaseOptions<S>): Observable<S>;
- /**
- * Generates an observable sequence by running a state-driven loop
- * producing the sequence's elements, using the specified scheduler
- * to send out observer messages.
- * The overload accepts options object that might contain initial state, iterate,
- * condition, result selector and scheduler.
- *
- * <img src="./img/generate.png" width="100%">
- *
- * @example <caption>Produces sequence of 0, 1, 2, ... 9, then completes.</caption>
- * var res = Rx.Observable.generate({
- * initialState: 0,
- * condition: x => x < 10,
- * iterate: x => x + 1,
- * resultSelector: x => x
- * });
- *
- * @see {@link from}
- * @see {@link create}
- *
- * @param {GenerateOptions<T, S>} options Object that must contain initialState, iterate, resultSelector and might contain condition and scheduler.
- * @returns {Observable<T>} The generated sequence.
- */
- static create<T, S>(options: GenerateOptions<T, S>): Observable<T>;
- /** @deprecated internal use only */ _subscribe(subscriber: Subscriber<any>): Subscription | Function | void;
- private static dispatch<T, S>(state);
- }
|