MoreEnumerable.Pad(TSource) Method (IEnumerable(TSource), Int32)

MoreEnumerablePadTSource Method (IEnumerableTSource, Int32)

Pads a sequence with default values if it is narrower (shorter in length) than a given width.

Namespace: MoreLinq
Assembly: MoreLinq (in MoreLinq.dll) Version: 2.0.0

Syntax

public static IEnumerable<TSource> Pad<TSource>(
	this IEnumerable<TSource> source,
	int width
)

<ExtensionAttribute>
Public Shared Function Pad(Of TSource) ( 
	source As IEnumerable(Of TSource),
	width As Integer
) As IEnumerable(Of TSource)

public:
[ExtensionAttribute]
generic<typename TSource>
static IEnumerable<TSource>^ Pad(
	IEnumerable<TSource>^ source, 
	int width
)

[<ExtensionAttribute>]
static member Pad : 
        source : IEnumerable<'TSource> * 
        width : int -> IEnumerable<'TSource>

source: Type: System.Collections.GenericIEnumerableTSource
The sequence to pad.
width: Type: SystemInt32
The width/length below which to pad.

Type: IEnumerableTSource
Returns a sequence that is at least as wide/long as the width/length specified by the width parameter.

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.

Examples

int[] numbers = { 123, 456, 789 };
IEnumerable<int> result = numbers.Pad(5);

The result variable, when iterated over, will yield 123, 456, 789 and two zeroes, in turn.