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

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

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