Enumerable.Zip Метод

Определение

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

System.Linq

Сборки:

netstandard.dll, 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

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

public:
generic <typename TFirst, typename TSecond, typename TResult>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<TResult> ^ Zip(System::Collections::Generic::IEnumerable<TFirst> ^ first, System::Collections::Generic::IEnumerable<TSecond> ^ second, Func<TFirst, TSecond, TResult> ^ resultSelector);

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);

static member Zip : seq<'First> * seq<'Second> * Func<'First, 'Second, 'Result> -> seq<'Result>

<Extension()>
Public Function Zip(Of TFirst, TSecond, TResult) (first As IEnumerable(Of TFirst), second As IEnumerable(Of TSecond), resultSelector As Func(Of TFirst, TSecond, TResult)) As IEnumerable(Of TResult)

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

TFirst

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

TSecond

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

TResult

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

Параметры

first

IEnumerable<TFirst>

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

second

IEnumerable<TSecond>

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

resultSelector

Func<TFirst,TSecond,TResult>

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

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

IEnumerable<TResult>

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

Исключения

ArgumentNullException

first или second есть null.

Примеры

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

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

Dim numbers() As Integer = {1, 2, 3, 4}
Dim words() As String = {"one", "two", "three"}
Dim numbersAndWords = numbers.Zip(words, Function(first, second) first & " " & second)

For Each item In numbersAndWords
    Console.WriteLine(item)
Next

' 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

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

public:
generic <typename TFirst, typename TSecond, typename TThird>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<ValueTuple<TFirst, TSecond, TThird>> ^ Zip(System::Collections::Generic::IEnumerable<TFirst> ^ first, System::Collections::Generic::IEnumerable<TSecond> ^ second, System::Collections::Generic::IEnumerable<TThird> ^ third);

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);

static member Zip : seq<'First> * seq<'Second> * seq<'hird> -> seq<ValueTuple<'First, 'Second, 'hird>>

<Extension()>
Public Function Zip(Of TFirst, TSecond, TThird) (first As IEnumerable(Of TFirst), second As IEnumerable(Of TSecond), third As IEnumerable(Of TThird)) As IEnumerable(Of ValueTuple(Of TFirst, TSecond, TThird))

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

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

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

public:
generic <typename TFirst, typename TSecond>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<ValueTuple<TFirst, TSecond>> ^ Zip(System::Collections::Generic::IEnumerable<TFirst> ^ first, System::Collections::Generic::IEnumerable<TSecond> ^ second);

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);

static member Zip : seq<'First> * seq<'Second> -> seq<ValueTuple<'First, 'Second>>

<Extension()>
Public Function Zip(Of TFirst, TSecond) (first As IEnumerable(Of TFirst), second As IEnumerable(Of TSecond)) As IEnumerable(Of ValueTuple(Of TFirst, TSecond))

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

TFirst

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

TSecond

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

Параметры

first

IEnumerable<TFirst>

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

second

IEnumerable<TSecond>

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

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

IEnumerable<ValueTuple<TFirst,TSecond>>

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

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

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