Enumerable.Zip Метод

Определение

Пространство имен:

System.Linq

Сборка:

System.Linq.dll

Перегрузки

Zip<TFirst,TSecond,TResult>(IEnumerable<TFirst>, IEnumerable<TSecond>, Func<TFirst,TSecond,TResult>)	Применяет указанную функцию к соответствующим элементам двух последовательностей, что дает последовательность результатов.
Zip<TFirst,TSecond,TThird>(IEnumerable<TFirst>, IEnumerable<TSecond>, IEnumerable<TThird>)	Создает последовательность кортежей с элементами из трех указанных последовательностей.
Zip<TFirst,TSecond>(IEnumerable<TFirst>, IEnumerable<TSecond>)	Создает последовательность кортежей с элементами из двух указанных последовательностей.

Zip<TFirst,TSecond,TResult>(IEnumerable<TFirst>, IEnumerable<TSecond>, Func<TFirst,TSecond,TResult>)

Исходный код:

Zip.cs

Применяет указанную функцию к соответствующим элементам двух последовательностей, что дает последовательность результатов.

C#

public static System.Collections.Generic.IEnumerable<TResult> Zip<TFirst,TSecond,TResult> (this System.Collections.Generic.IEnumerable<TFirst> first, System.Collections.Generic.IEnumerable<TSecond> second, Func<TFirst,TSecond,TResult> resultSelector);

Параметры типа

TFirst

Тип элементов первой входной последовательности.

TSecond

Тип элементов второй входной последовательности.

TResult

Тип элементов результирующей последовательности.

Параметры

first

IEnumerable<TFirst>

Первая последовательность для объединения.

second

IEnumerable<TSecond>

Вторая последовательность для объединения.

resultSelector

Func<TFirst,TSecond,TResult>

Функция, которая определяет, как объединить элементы двух последовательностей.

Возвращаемое значение

IEnumerable<TResult>

Объект IEnumerable<T>, содержащий объединенные элементы двух входных последовательностей.

Исключения

ArgumentNullException

Параметр first или second имеет значение null.

Примеры

В следующем примере кода показано, как использовать Zip метод для слияния двух последовательностей.

C#

int[] numbers = { 1, 2, 3, 4 };
string[] words = { "one", "two", "three" };

var numbersAndWords = numbers.Zip(words, (first, second) => first + " " + second);

foreach (var item in numbersAndWords)
    Console.WriteLine(item);

// This code produces the following output:

// 1 one
// 2 two
// 3 three

Комментарии

Этот метод реализуется с помощью отложенного выполнения. Немедленное возвращаемое значение — это объект, в котором хранятся все сведения, необходимые для выполнения действия. Запрос, представленный этим методом, не выполняется, пока объект не будет перечислен либо путем вызова его GetEnumerator метода напрямую, либо с помощью foreach в C# или For Each в Visual Basic.

Метод объединяет каждый элемент первой последовательности с элементом, который имеет тот же индекс во второй последовательности. Если последовательности имеют не одинаковое количество элементов, метод объединяет последовательности, пока не достигнет конца одного из них. Например, если одна последовательность содержит три элемента, а другая — четыре, результирующий последовательность будет содержать только три элемента.

См. также раздел

• Операции проекции — ZIP

Zip<TFirst,TSecond,TThird>(IEnumerable<TFirst>, IEnumerable<TSecond>, IEnumerable<TThird>)

Исходный код:

Zip.cs

Создает последовательность кортежей с элементами из трех указанных последовательностей.

C#

public static System.Collections.Generic.IEnumerable<(TFirst First, TSecond Second, TThird Third)> Zip<TFirst,TSecond,TThird> (this System.Collections.Generic.IEnumerable<TFirst> first, System.Collections.Generic.IEnumerable<TSecond> second, System.Collections.Generic.IEnumerable<TThird> third);

Параметры типа

TFirst

Тип элементов первой входной последовательности.

TSecond

Тип элементов второй входной последовательности.

TThird

Тип элементов третьей входной последовательности.

Параметры

first

IEnumerable<TFirst>

Первая последовательность для объединения.

second

IEnumerable<TSecond>

Вторая последовательность для объединения.

third

IEnumerable<TThird>

Третья последовательность для слияния.

Возвращаемое значение

IEnumerable<ValueTuple<TFirst,TSecond,TThird>>

Последовательность кортежей с элементами, взятыми из первой, второй и третьей последовательностей в этом порядке.

См. также раздел

• Операции проекции — ZIP

Zip<TFirst,TSecond>(IEnumerable<TFirst>, IEnumerable<TSecond>)

Исходный код:

Zip.cs

Создает последовательность кортежей с элементами из двух указанных последовательностей.

C#

public static System.Collections.Generic.IEnumerable<(TFirst First, TSecond Second)> Zip<TFirst,TSecond> (this System.Collections.Generic.IEnumerable<TFirst> first, System.Collections.Generic.IEnumerable<TSecond> second);

Параметры типа

TFirst

Тип элементов первой входной последовательности.

TSecond

Тип элементов второй входной последовательности.

Параметры

first

IEnumerable<TFirst>

Первая последовательность для объединения.

second

IEnumerable<TSecond>

Вторая последовательность для объединения.

Возвращаемое значение

IEnumerable<ValueTuple<TFirst,TSecond>>

Последовательность кортежей с элементами, взятыми из первой и второй последовательностей в указанном порядке.

См. также раздел

• Операции проекции — ZIP