|
@@ -545,12 +545,12 @@ namespace System.Reactive.Linq
|
|
|
}
|
|
|
|
|
|
/// <summary>
|
|
|
- /// Projects each element of an observable sequence to an observable sequence and merges the resulting observable sequences into one observable sequence.
|
|
|
+ /// Projects each element of an observable sequence to an observable sequence by incorporating the element's index and merges the resulting observable sequences into one observable sequence.
|
|
|
/// </summary>
|
|
|
/// <typeparam name="TSource">The type of the elements in the source sequence.</typeparam>
|
|
|
/// <typeparam name="TResult">The type of the elements in the projected inner sequences and the elements in the merged result sequence.</typeparam>
|
|
|
/// <param name="source">An observable sequence of elements to project.</param>
|
|
|
- /// <param name="selector">A transform function to apply to each source element; the second parameter of the function represents the index of the source element.</param>
|
|
|
+ /// <param name="selector">A transform function to apply to each element; the second parameter of the function represents the index of the source element.</param>
|
|
|
/// <returns>An observable sequence whose elements are the result of invoking the one-to-many transform function on each element of the input sequence.</returns>
|
|
|
/// <exception cref="ArgumentNullException"><paramref name="source"/> or <paramref name="selector"/> is null.</exception>
|
|
|
public static IObservable<TResult> SelectMany<TSource, TResult>(this IObservable<TSource> source, Func<TSource, int, IObservable<TResult>> selector)
|
|
@@ -584,6 +584,26 @@ namespace System.Reactive.Linq
|
|
|
return s_impl.SelectMany<TSource, TResult>(source, selector);
|
|
|
}
|
|
|
|
|
|
+ /// <summary>
|
|
|
+ /// Projects each element of an observable sequence to a task by incorporating the element's index and merges all of the task results into one observable sequence.
|
|
|
+ /// </summary>
|
|
|
+ /// <typeparam name="TSource">The type of the elements in the source sequence.</typeparam>
|
|
|
+ /// <typeparam name="TResult">The type of the result produced by the projected tasks and the elements in the merged result sequence.</typeparam>
|
|
|
+ /// <param name="source">An observable sequence of elements to project.</param>
|
|
|
+ /// <param name="selector">A transform function to apply to each element; the second parameter of the function represents the index of the source element.</param>
|
|
|
+ /// <returns>An observable sequence whose elements are the result of the tasks executed for each element of the input sequence.</returns>
|
|
|
+ /// <remarks>This overload supports composition of observable sequences and tasks, without requiring manual conversion of the tasks to observable sequences using <see cref="TaskObservableExtensions.ToObservable<TResult>"/>.</remarks>
|
|
|
+ /// <exception cref="ArgumentNullException"><paramref name="source"/> or <paramref name="selector"/> is null.</exception>
|
|
|
+ public static IObservable<TResult> SelectMany<TSource, TResult>(this IObservable<TSource> source, Func<TSource, int, Task<TResult>> selector)
|
|
|
+ {
|
|
|
+ if (source == null)
|
|
|
+ throw new ArgumentNullException("source");
|
|
|
+ if (selector == null)
|
|
|
+ throw new ArgumentNullException("selector");
|
|
|
+
|
|
|
+ return s_impl.SelectMany<TSource, TResult>(source, selector);
|
|
|
+ }
|
|
|
+
|
|
|
/// <summary>
|
|
|
/// Projects each element of an observable sequence to a task with cancellation support and merges all of the task results into one observable sequence.
|
|
|
/// </summary>
|
|
@@ -603,6 +623,26 @@ namespace System.Reactive.Linq
|
|
|
|
|
|
return s_impl.SelectMany<TSource, TResult>(source, selector);
|
|
|
}
|
|
|
+
|
|
|
+ /// <summary>
|
|
|
+ /// Projects each element of an observable sequence to a task by incorporating the element's index with cancellation support and merges all of the task results into one observable sequence.
|
|
|
+ /// </summary>
|
|
|
+ /// <typeparam name="TSource">The type of the elements in the source sequence.</typeparam>
|
|
|
+ /// <typeparam name="TResult">The type of the result produced by the projected tasks and the elements in the merged result sequence.</typeparam>
|
|
|
+ /// <param name="source">An observable sequence of elements to project.</param>
|
|
|
+ /// <param name="selector">A transform function to apply to each element; the second parameter of the function represents the index of the source element.</param>
|
|
|
+ /// <returns>An observable sequence whose elements are the result of the tasks executed for each element of the input sequence.</returns>
|
|
|
+ /// <remarks>This overload supports composition of observable sequences and tasks, without requiring manual conversion of the tasks to observable sequences using <see cref="TaskObservableExtensions.ToObservable<TResult>"/>.</remarks>
|
|
|
+ /// <exception cref="ArgumentNullException"><paramref name="source"/> or <paramref name="selector"/> is null.</exception>
|
|
|
+ public static IObservable<TResult> SelectMany<TSource, TResult>(this IObservable<TSource> source, Func<TSource, int, CancellationToken, Task<TResult>> selector)
|
|
|
+ {
|
|
|
+ if (source == null)
|
|
|
+ throw new ArgumentNullException("source");
|
|
|
+ if (selector == null)
|
|
|
+ throw new ArgumentNullException("selector");
|
|
|
+
|
|
|
+ return s_impl.SelectMany<TSource, TResult>(source, selector);
|
|
|
+ }
|
|
|
#endif
|
|
|
|
|
|
/// <summary>
|
|
@@ -629,14 +669,14 @@ namespace System.Reactive.Linq
|
|
|
}
|
|
|
|
|
|
/// <summary>
|
|
|
- /// Projects each element of an observable sequence to an observable sequence, invokes the result selector for the source element and each of the corresponding inner sequence's elements, and merges the results into one observable sequence.
|
|
|
+ /// Projects each element of an observable sequence to an observable sequence by incorporating the element's index, invokes the result selector for the source element and each of the corresponding inner sequence's elements, and merges the results into one observable sequence.
|
|
|
/// </summary>
|
|
|
/// <typeparam name="TSource">The type of the elements in the source sequence.</typeparam>
|
|
|
/// <typeparam name="TCollection">The type of the elements in the projected intermediate sequences.</typeparam>
|
|
|
/// <typeparam name="TResult">The type of the elements in the result sequence, obtained by using the selector to combine source sequence elements with their corresponding intermediate sequence elements.</typeparam>
|
|
|
/// <param name="source">An observable sequence of elements to project.</param>
|
|
|
- /// <param name="collectionSelector">A transform function to apply to each source element; the second parameter of the function represents the index of the source element.</param>
|
|
|
- /// <param name="resultSelector">A transform function to apply to each element of the intermediate sequence.</param>
|
|
|
+ /// <param name="collectionSelector">A transform function to apply to each element; the second parameter of the function represents the index of the source element.</param>
|
|
|
+ /// <param name="resultSelector">A transform function to apply to each element of the intermediate sequence; the second parameter of the function represents the index of the source element and the fourth parameter represents the index of the intermediate element.</param>
|
|
|
/// <returns>An observable sequence whose elements are the result of invoking the one-to-many transform function collectionSelector on each element of the input sequence and then mapping each of those sequence elements and their corresponding source element to a result element.</returns>
|
|
|
/// <exception cref="ArgumentNullException"><paramref name="source"/> or <paramref name="collectionSelector"/> or <paramref name="resultSelector"/> is null.</exception>
|
|
|
public static IObservable<TResult> SelectMany<TSource, TCollection, TResult>(this IObservable<TSource> source, Func<TSource, int, IObservable<TCollection>> collectionSelector, Func<TSource, int, TCollection, int, TResult> resultSelector)
|
|
@@ -676,6 +716,30 @@ namespace System.Reactive.Linq
|
|
|
return s_impl.SelectMany<TSource, TTaskResult, TResult>(source, taskSelector, resultSelector);
|
|
|
}
|
|
|
|
|
|
+ /// <summary>
|
|
|
+ /// Projects each element of an observable sequence to a task by incorporating the element's index, invokes the result selector for the source element and the task result, and merges the results into one observable sequence.
|
|
|
+ /// </summary>
|
|
|
+ /// <typeparam name="TSource">The type of the elements in the source sequence.</typeparam>
|
|
|
+ /// <typeparam name="TTaskResult">The type of the results produced by the projected intermediate tasks.</typeparam>
|
|
|
+ /// <typeparam name="TResult">The type of the elements in the result sequence, obtained by using the selector to combine source sequence elements with their corresponding intermediate task results.</typeparam>
|
|
|
+ /// <param name="source">An observable sequence of elements to project.</param>
|
|
|
+ /// <param name="taskSelector">A transform function to apply to each element; the second parameter of the function represents the index of the source element.</param>
|
|
|
+ /// <param name="resultSelector">A transform function to apply to each element of the intermediate sequence; the second parameter of the function represents the index of the source element.</param>
|
|
|
+ /// <returns>An observable sequence whose elements are the result of obtaining a task for each element of the input sequence and then mapping the task's result and its corresponding source element to a result element.</returns>
|
|
|
+ /// <exception cref="ArgumentNullException"><paramref name="source"/> or <paramref name="taskSelector"/> or <paramref name="resultSelector"/> is null.</exception>
|
|
|
+ /// <remarks>This overload supports using LINQ query comprehension syntax in C# and Visual Basic to compose observable sequences and tasks, without requiring manual conversion of the tasks to observable sequences using <see cref="TaskObservableExtensions.ToObservable<TResult>"/>.</remarks>
|
|
|
+ public static IObservable<TResult> SelectMany<TSource, TTaskResult, TResult>(this IObservable<TSource> source, Func<TSource, int, Task<TTaskResult>> taskSelector, Func<TSource, int, TTaskResult, TResult> resultSelector)
|
|
|
+ {
|
|
|
+ if (source == null)
|
|
|
+ throw new ArgumentNullException("source");
|
|
|
+ if (taskSelector == null)
|
|
|
+ throw new ArgumentNullException("taskSelector");
|
|
|
+ if (resultSelector == null)
|
|
|
+ throw new ArgumentNullException("resultSelector");
|
|
|
+
|
|
|
+ return s_impl.SelectMany<TSource, TTaskResult, TResult>(source, taskSelector, resultSelector);
|
|
|
+ }
|
|
|
+
|
|
|
/// <summary>
|
|
|
/// Projects each element of an observable sequence to a task with cancellation support, invokes the result selector for the source element and the task result, and merges the results into one observable sequence.
|
|
|
/// </summary>
|
|
@@ -699,6 +763,30 @@ namespace System.Reactive.Linq
|
|
|
|
|
|
return s_impl.SelectMany<TSource, TTaskResult, TResult>(source, taskSelector, resultSelector);
|
|
|
}
|
|
|
+
|
|
|
+ /// <summary>
|
|
|
+ /// Projects each element of an observable sequence to a task by incorporating the element's index with cancellation support, invokes the result selector for the source element and the task result, and merges the results into one observable sequence.
|
|
|
+ /// </summary>
|
|
|
+ /// <typeparam name="TSource">The type of the elements in the source sequence.</typeparam>
|
|
|
+ /// <typeparam name="TTaskResult">The type of the results produced by the projected intermediate tasks.</typeparam>
|
|
|
+ /// <typeparam name="TResult">The type of the elements in the result sequence, obtained by using the selector to combine source sequence elements with their corresponding intermediate task results.</typeparam>
|
|
|
+ /// <param name="source">An observable sequence of elements to project.</param>
|
|
|
+ /// <param name="taskSelector">A transform function to apply to each element; the second parameter of the function represents the index of the source element.</param>
|
|
|
+ /// <param name="resultSelector">A transform function to apply to each element of the intermediate sequence; the second parameter of the function represents the index of the source element.</param>
|
|
|
+ /// <returns>An observable sequence whose elements are the result of obtaining a task for each element of the input sequence and then mapping the task's result and its corresponding source element to a result element.</returns>
|
|
|
+ /// <exception cref="ArgumentNullException"><paramref name="source"/> or <paramref name="taskSelector"/> or <paramref name="resultSelector"/> is null.</exception>
|
|
|
+ /// <remarks>This overload supports using LINQ query comprehension syntax in C# and Visual Basic to compose observable sequences and tasks, without requiring manual conversion of the tasks to observable sequences using <see cref="TaskObservableExtensions.ToObservable<TResult>"/>.</remarks>
|
|
|
+ public static IObservable<TResult> SelectMany<TSource, TTaskResult, TResult>(this IObservable<TSource> source, Func<TSource, int, CancellationToken, Task<TTaskResult>> taskSelector, Func<TSource, int, TTaskResult, TResult> resultSelector)
|
|
|
+ {
|
|
|
+ if (source == null)
|
|
|
+ throw new ArgumentNullException("source");
|
|
|
+ if (taskSelector == null)
|
|
|
+ throw new ArgumentNullException("taskSelector");
|
|
|
+ if (resultSelector == null)
|
|
|
+ throw new ArgumentNullException("resultSelector");
|
|
|
+
|
|
|
+ return s_impl.SelectMany<TSource, TTaskResult, TResult>(source, taskSelector, resultSelector);
|
|
|
+ }
|
|
|
#endif
|
|
|
|
|
|
/// <summary>
|
|
@@ -727,17 +815,17 @@ namespace System.Reactive.Linq
|
|
|
}
|
|
|
|
|
|
/// <summary>
|
|
|
- /// Projects each notification of an observable sequence to an observable sequence and merges the resulting observable sequences into one observable sequence.
|
|
|
+ /// Projects each notification of an observable sequence to an observable sequence by incorporating the element's index and merges the resulting observable sequences into one observable sequence.
|
|
|
/// </summary>
|
|
|
/// <typeparam name="TSource">The type of the elements in the source sequence.</typeparam>
|
|
|
/// <typeparam name="TResult">The type of the elements in the projected inner sequences and the elements in the merged result sequence.</typeparam>
|
|
|
/// <param name="source">An observable sequence of notifications to project.</param>
|
|
|
- /// <param name="onNext">A transform function to apply to each element; the second parameter represents the index of the source element.</param>
|
|
|
- /// <param name="onError">A transform function to apply when an error occurs in the source sequence; the second parameter represents the index of the source element.</param>
|
|
|
- /// <param name="onCompleted">A transform function to apply when the end of the source sequence is reached; the second parameter represents the number of elements observed.</param>
|
|
|
+ /// <param name="onNext">A transform function to apply to each element; the second parameter of the function represents the index of the source element.</param>
|
|
|
+ /// <param name="onError">A transform function to apply when an error occurs in the source sequence.</param>
|
|
|
+ /// <param name="onCompleted">A transform function to apply when the end of the source sequence is reached.</param>
|
|
|
/// <returns>An observable sequence whose elements are the result of invoking the one-to-many transform function corresponding to each notification in the input sequence.</returns>
|
|
|
/// <exception cref="ArgumentNullException"><paramref name="source"/> or <paramref name="onNext"/> or <paramref name="onError"/> or <paramref name="onCompleted"/> is null.</exception>
|
|
|
- public static IObservable<TResult> SelectMany<TSource, TResult>(this IObservable<TSource> source, Func<TSource, int, IObservable<TResult>> onNext, Func<Exception, int, IObservable<TResult>> onError, Func<int, IObservable<TResult>> onCompleted)
|
|
|
+ public static IObservable<TResult> SelectMany<TSource, TResult>(this IObservable<TSource> source, Func<TSource, int, IObservable<TResult>> onNext, Func<Exception, IObservable<TResult>> onError, Func<IObservable<TResult>> onCompleted)
|
|
|
{
|
|
|
if (source == null)
|
|
|
throw new ArgumentNullException("source");
|
|
@@ -772,13 +860,12 @@ namespace System.Reactive.Linq
|
|
|
}
|
|
|
|
|
|
/// <summary>
|
|
|
- /// Projects each element of an observable sequence to an enumerable sequence and concatenates the resulting enumerable sequences into one observable sequence.
|
|
|
- /// The index of each source element is used in the projected form of that element.
|
|
|
+ /// Projects each element of an observable sequence to an enumerable sequence by incorporating the element's index and concatenates the resulting enumerable sequences into one observable sequence.
|
|
|
/// </summary>
|
|
|
/// <typeparam name="TSource">The type of the elements in the source sequence.</typeparam>
|
|
|
/// <typeparam name="TResult">The type of the elements in the projected inner enumerable sequences and the elements in the merged result sequence.</typeparam>
|
|
|
/// <param name="source">An observable sequence of elements to project.</param>
|
|
|
- /// <param name="selector">A transform function to apply to each source element; the second parameter of the function represents the index of the source element.</param>
|
|
|
+ /// <param name="selector">A transform function to apply to each element; the second parameter of the function represents the index of the source element.</param>
|
|
|
/// <returns>An observable sequence whose elements are the result of invoking the one-to-many transform function on each element of the input sequence.</returns>
|
|
|
/// <exception cref="ArgumentNullException"><paramref name="source"/> or <paramref name="selector"/> is null.</exception>
|
|
|
/// <remarks>The projected sequences are enumerated synchonously within the OnNext call of the source sequence. In order to do a concurrent, non-blocking merge, change the selector to return an observable sequence obtained using the <see cref="Observable.ToObservable<TSource>(IEnumerable<TSource>)"/> conversion.</remarks>
|
|
@@ -817,14 +904,14 @@ namespace System.Reactive.Linq
|
|
|
}
|
|
|
|
|
|
/// <summary>
|
|
|
- /// Projects each element of an observable sequence to an enumerable sequence, invokes the result selector for the source element and each of the corresponding inner sequence's elements, and merges the results into one observable sequence.
|
|
|
+ /// Projects each element of an observable sequence to an enumerable sequence by incorporating the element's index, invokes the result selector for the source element and each of the corresponding inner sequence's elements, and merges the results into one observable sequence.
|
|
|
/// </summary>
|
|
|
/// <typeparam name="TSource">The type of the elements in the source sequence.</typeparam>
|
|
|
/// <typeparam name="TCollection">The type of the elements in the projected intermediate enumerable sequences.</typeparam>
|
|
|
/// <typeparam name="TResult">The type of the elements in the result sequence, obtained by using the selector to combine source sequence elements with their corresponding intermediate sequence elements.</typeparam>
|
|
|
/// <param name="source">An observable sequence of elements to project.</param>
|
|
|
/// <param name="collectionSelector">A transform function to apply to each element; the second parameter of the function represents the index of the source element.</param>
|
|
|
- /// <param name="resultSelector">A transform function to apply to each element of the intermediate sequence.</param>
|
|
|
+ /// <param name="resultSelector">A transform function to apply to each element of the intermediate sequence; the second parameter of the function represents the index of the source element and the fourth parameter represents the index of the intermediate element.</param>
|
|
|
/// <returns>An observable sequence whose elements are the result of invoking the one-to-many transform function collectionSelector on each element of the input sequence and then mapping each of those sequence elements and their corresponding source element to a result element.</returns>
|
|
|
/// <exception cref="ArgumentNullException"><paramref name="source"/> or <paramref name="collectionSelector"/> or <paramref name="resultSelector"/> is null.</exception>
|
|
|
/// <remarks>The projected sequences are enumerated synchonously within the OnNext call of the source sequence. In order to do a concurrent, non-blocking merge, change the selector to return an observable sequence obtained using the <see cref="Observable.ToObservable<TSource>(IEnumerable<TSource>)"/> conversion.</remarks>
|