MoreEnumerableScanRightTSource, TAccumulate(IEnumerableTSource, TAccumulate, FuncTSource, TAccumulate, TAccumulate) Method

Performs a right-associative scan (inclusive prefix) on a sequence of elements. The specified seed value is used as the initial accumulator value. This operator is the right-associative version of the ScanTSource, TState(IEnumerableTSource, TState, FuncTState, TSource, TState) LINQ operator.

Definition

Namespace: MoreLinq
Assembly: MoreLinq (in MoreLinq.dll) Version: 4.1.0+0e154ef592f33ce0f6f3d534a9eedee273f0ce72

C#

public static IEnumerable<TAccumulate> ScanRight<TSource, TAccumulate>(
	this IEnumerable<TSource> source,
	TAccumulate seed,
	Func<TSource, TAccumulate, TAccumulate> func
)

VB

<ExtensionAttribute>
Public Shared Function ScanRight(Of TSource, TAccumulate) ( 
	source As IEnumerable(Of TSource),
	seed As TAccumulate,
	func As Func(Of TSource, TAccumulate, TAccumulate)
) As IEnumerable(Of TAccumulate)

C++

public:
[ExtensionAttribute]
generic<typename TSource, typename TAccumulate>
static IEnumerable<TAccumulate>^ ScanRight(
	IEnumerable<TSource>^ source, 
	TAccumulate seed, 
	Func<TSource, TAccumulate, TAccumulate>^ func
)

F#

[<ExtensionAttribute>]
static member ScanRight : 
        source : IEnumerable<'TSource> * 
        seed : 'TAccumulate * 
        func : Func<'TSource, 'TAccumulate, 'TAccumulate> -> IEnumerable<'TAccumulate>

Parameters

source IEnumerableTSource: Source sequence.
seed TAccumulate: The initial accumulator value.
func FuncTSource, TAccumulate, TAccumulate: A right-associative accumulator function to be invoked on each element.

Type Parameters

TSource: The type of the elements of source.
TAccumulate: The type of the accumulator value.

Return Value

IEnumerableTAccumulate
The scanned sequence.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type IEnumerableTSource. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Remarks

This operator uses deferred execution and streams its results. Source sequence is consumed greedily when an iteration of the resulting sequence begins.

Example

C#

var result = Enumerable.Range(1, 4).ScanRight("5", (a, b) => $"({a}+{b})");

The result variable will contain [ "(1+(2+(3+(4+5))))", "(2+(3+(4+5)))", "(3+(4+5))", "(4+5)", "5" ].