Method Replace

| Edit this page

Replace<TSource>(IEnumerable<TSource>, int, TSource)

Replaces a single value in a sequence at a specified index with the given replacement value.

Declaration
public static IEnumerable<TSource> Replace<TSource>(this IEnumerable<TSource> source, int index, TSource value)
Parameters
Type Name Description
IEnumerable<TSource> source

The source sequence.
int index

The index of the value to replace.
TSource value

The replacement value to use at index.
Returns
Type Description
IEnumerable<TSource>

A sequence with the original values from source, except for position index which has the value value.
Type Parameters
Name Description
TSource

Type of item in the sequence
Remarks

This operator evaluates in a deferred and streaming manner.

Examples

The following code example demonstrates how to replace a value using Replace.

var sequence = Enumerable.Range(1, 10);

// Replace a value in a sequence
var result = sequence
    .Replace(3, -100);

Console.WriteLine(
    "[" +
    string.Join(", ", result) +
    "]");

// This code produces the following output:
// [1, 2, 3, -100, 5, 6, 7, 8, 9, 10]
Exceptions
Type Condition
ArgumentNullException

source is null.
| Edit this page

Replace<TSource>(IEnumerable<TSource>, Index, TSource)

Replaces a single value in a sequence at a specified index with the given replacement value.

Declaration
public static IEnumerable<TSource> Replace<TSource>(this IEnumerable<TSource> source, Index index, TSource value)
Parameters
Type Name Description
IEnumerable<TSource> source

The source sequence.
Index index

The index of the value to replace.
TSource value

The replacement value to use at index.
Returns
Type Description
IEnumerable<TSource>

A sequence with the original values from source, except for position index which has the value value.
Type Parameters
Name Description
TSource

Type of item in the sequence
Remarks

This operator evaluates in a deferred and streaming manner.

Examples

The following code example demonstrates how to replace a value using Replace.

var sequence = Enumerable.Range(1, 10);

// Replace a value in a sequence
var result = sequence
    .Replace(^3, -100);

Console.WriteLine(
    "[" +
    string.Join(", ", result) +
    "]");

// This code produces the following output:
// [1, 2, 3, 4, 5, 6, 7, -100, 9, 10]
Exceptions
Type Condition
ArgumentNullException

source is null.