Enumerable.Zip Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.dll

Sobrecargas

Zip<TFirst,TSecond,TResult>(IEnumerable<TFirst>, IEnumerable<TSecond>, Func<TFirst,TSecond,TResult>)	Aplica uma função especificada para os elementos correspondentes de duas sequências, produzindo uma sequência dos resultados.
Zip<TFirst,TSecond,TThird>(IEnumerable<TFirst>, IEnumerable<TSecond>, IEnumerable<TThird>)	Produz uma sequência de tuplas com elementos das três sequências especificadas.
Zip<TFirst,TSecond>(IEnumerable<TFirst>, IEnumerable<TSecond>)	Produz uma sequência de tuplas com elementos das duas sequências especificadas.

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

Origem:

Zip.cs

Aplica uma função especificada para os elementos correspondentes de duas sequências, produzindo uma sequência dos resultados.

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)

Parâmetros de tipo

TFirst

O tipo de elementos na primeira sequência de entrada.

TSecond

O tipo de elementos na segunda sequência de entrada.

TResult

O tipo de elementos na sequência de resultado.

Parâmetros

first

IEnumerable<TFirst>

A primeira sequência a ser mesclada.

second

IEnumerable<TSecond>

A segunda sequência a ser mesclada.

resultSelector

Func<TFirst,TSecond,TResult>

Uma função que especifica como mesclar os elementos das duas sequências.

Retornos

IEnumerable<TResult>

Um IEnumerable<T> que contém elementos mesclados de duas sequências de entrada.

Exceções

ArgumentNullException

first ou second é null.

Exemplos

O exemplo de código a seguir demonstra como usar o Zip método para mesclar duas sequências.

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

Comentários

Esse método é implementado usando a execução adiada. O valor retornado imediato é um objeto que armazena todas as informações necessárias para executar a ação. A consulta representada por esse método não é executada até que o objeto seja enumerado chamando seu GetEnumerator método diretamente ou usando foreach em C# ou For Each no Visual Basic.

O método mescla cada elemento da primeira sequência com um elemento que tem o mesmo índice na segunda sequência. Se as sequências não tiverem o mesmo número de elementos, o método mesclará sequências até chegar ao final de um deles. Por exemplo, se uma sequência tiver três elementos e a outra tiver quatro, a sequência de resultados terá apenas três elementos.

Confira também

• Operações de projeção – Zip

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

Origem:

Zip.cs

Produz uma sequência de tuplas com elementos das três sequências especificadas.

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

Parâmetros de tipo

TFirst

O tipo de elementos na primeira sequência de entrada.

TSecond

O tipo de elementos na segunda sequência de entrada.

TThird

O tipo dos elementos da terceira sequência de entrada.

Parâmetros

first

IEnumerable<TFirst>

A primeira sequência a ser mesclada.

second

IEnumerable<TSecond>

A segunda sequência a ser mesclada.

third

IEnumerable<TThird>

A terceira sequência a ser mesclada.

Retornos

IEnumerable<ValueTuple<TFirst,TSecond,TThird>>

Uma sequência de tuplas com elementos obtidos da primeira, segunda e terceira sequências, nessa ordem.

Confira também

• Operações de projeção – Zip

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

Origem:

Zip.cs

Produz uma sequência de tuplas com elementos das duas sequências especificadas.

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

Parâmetros de tipo

TFirst

O tipo de elementos na primeira sequência de entrada.

TSecond

O tipo de elementos na segunda sequência de entrada.

Parâmetros

first

IEnumerable<TFirst>

A primeira sequência a ser mesclada.

second

IEnumerable<TSecond>

A segunda sequência a ser mesclada.

Retornos

IEnumerable<ValueTuple<TFirst,TSecond>>

Uma sequência de tuplas com elementos extraídos da primeira e segunda sequências, nessa ordem.

Confira também

• Operações de projeção – Zip