BatchExtensionBatchTSource, TResult(IEnumerableTSource, Int32, FuncIEnumerableTSource, TResult) Method

Batches the source sequence into sized buckets and applies a projection to each bucket.

Definition

Namespace: MoreLinq.Extensions
Assembly: MoreLinq (in MoreLinq.dll) Version: 3.4.0+b99a6a8cc504caf2d48372fe54a2f8116c59cd0c

C#

public static IEnumerable<TResult> Batch<TSource, TResult>(
	this IEnumerable<TSource> source,
	int size,
	Func<IEnumerable<TSource>, TResult> resultSelector
)

VB

<ExtensionAttribute>
Public Shared Function Batch(Of TSource, TResult) ( 
	source As IEnumerable(Of TSource),
	size As Integer,
	resultSelector As Func(Of IEnumerable(Of TSource), TResult)
) As IEnumerable(Of TResult)

C++

public:
[ExtensionAttribute]
generic<typename TSource, typename TResult>
static IEnumerable<TResult>^ Batch(
	IEnumerable<TSource>^ source, 
	int size, 
	Func<IEnumerable<TSource>^, TResult>^ resultSelector
)

F#

[<ExtensionAttribute>]
static member Batch : 
        source : IEnumerable<'TSource> * 
        size : int * 
        resultSelector : Func<IEnumerable<'TSource>, 'TResult> -> IEnumerable<'TResult>

Parameters

source IEnumerableTSource: The source sequence.
size Int32: Size of buckets.
resultSelector FuncIEnumerableTSource, TResult: The projection to apply to each bucket.

Type Parameters

TSource: Type of elements in source sequence.
TResult: Type of result returned by resultSelector.

Return Value

IEnumerableTResult
A sequence of projections on equally sized buckets containing elements of the source collection.

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 (buckets are streamed but their content buffered).

When more than one bucket is streamed, all buckets except the last is guaranteed to have size elements. The last bucket may be smaller depending on the remaining elements in the source sequence.

Each bucket is pre-allocated to size elements. If size is set to a very large value, e.g. MaxValue to effectively disable batching by just hoping for a single bucket, then it can lead to memory exhaustion (OutOfMemoryException).