Tuple<T1,T2,T3,T4> Classe

Definição

generic <typename T1, typename T2, typename T3, typename T4>
public ref class Tuple : IComparable, System::Collections::IStructuralComparable, System::Collections::IStructuralEquatable

generic <typename T1, typename T2, typename T3, typename T4>
public ref class Tuple : IComparable, System::Collections::IStructuralComparable, System::Collections::IStructuralEquatable, System::Runtime::CompilerServices::ITuple

public class Tuple<T1,T2,T3,T4> : IComparable, System.Collections.IStructuralComparable, System.Collections.IStructuralEquatable

[System.Serializable]
public class Tuple<T1,T2,T3,T4> : IComparable, System.Collections.IStructuralComparable, System.Collections.IStructuralEquatable

public class Tuple<T1,T2,T3,T4> : IComparable, System.Collections.IStructuralComparable, System.Collections.IStructuralEquatable, System.Runtime.CompilerServices.ITuple

type Tuple<'T1, 'T2, 'T3, 'T4> = class
    interface IStructuralComparable
    interface IStructuralEquatable
    interface IComparable

[<System.Serializable>]
type Tuple<'T1, 'T2, 'T3, 'T4> = class
    interface IStructuralEquatable
    interface IStructuralComparable
    interface IComparable

[<System.Serializable>]
type Tuple<'T1, 'T2, 'T3, 'T4> = class
    interface IStructuralEquatable
    interface IStructuralComparable
    interface IComparable
    interface ITuple

type Tuple<'T1, 'T2, 'T3, 'T4> = class
    interface IStructuralComparable
    interface IStructuralEquatable
    interface IComparable
    interface ITuple

Public Class Tuple(Of T1, T2, T3, T4)
Implements IComparable, IStructuralComparable, IStructuralEquatable

Public Class Tuple(Of T1, T2, T3, T4)
Implements IComparable, IStructuralComparable, IStructuralEquatable, ITuple

Parâmetros de tipo

Herança

Object

Tuple<T1,T2,T3,T4>

Atributos

SerializableAttribute

Implementações

IStructuralComparable IStructuralEquatable IComparable ITuple

Comentários

Uma tupla é uma estrutura de dados que tem um número específico e uma sequência de valores. A Tuple<T1,T2,T3,T4> classe representa uma tupla de 4 ou quádruplo, que é uma tupla que tem quatro componentes.

Você pode criar uma instância de um Tuple<T1,T2,T3,T4> objeto chamando o Tuple<T1,T2,T3,T4> construtor ou o método estático Tuple.Create<T1,T2,T3,T4>(T1, T2, T3, T4) . Você pode recuperar o valor dos componentes da tupla usando as propriedades somente Item1Item2leitura e Item3Item4 instância.

As tuplas são comumente usadas de quatro maneiras diferentes:

• Para representar um único conjunto de dados. Por exemplo, uma tupla pode representar um registro de banco de dados e seus componentes podem representar campos individuais do registro.

• Para fornecer acesso fácil e manipulação de um conjunto de dados. O exemplo a seguir define uma matriz de Tuple<T1,T2,T3,T4> objetos que contêm os nomes dos arremessadores de beisebol, o número de innings que eles lançaram e o número de corridas ganhas (corridas que marcaram sem erros de campo) e acertos que eles desistiram. A matriz é passada para o ComputeStatistics método, que calcula a média de execução ganha de cada arremessador (o número médio de corridas entregues em um jogo de nove innings), e o número médio de acertos desapurados por inning. O método também usa essas duas médias para calcular uma média de eficácia hipotética.

  using System;
  using System.Collections.Generic;
  
  public class Example
  {
     public static void Main()
     {
        Tuple<string, decimal, int, int>[] pitchers  =  
             { Tuple.Create("McHale, Joe", 240.1m, 221, 96),
               Tuple.Create("Paul, Dave", 233.1m, 231, 84), 
               Tuple.Create("Williams, Mike", 193.2m, 183, 86),
               Tuple.Create("Blair, Jack", 168.1m, 146, 65), 
               Tuple.Create("Henry, Walt", 140.1m, 96, 30),
               Tuple.Create("Lee, Adam", 137.2m, 109, 45),
               Tuple.Create("Rohr, Don", 101.0m, 110, 42) };
        Tuple<string, double, double, double>[] results= ComputeStatistics(pitchers);
  
        // Display the results.
        Console.WriteLine("{0,-20} {1,9} {2,11} {3,15}\n", 
                          "Pitcher", "ERA", "Hits/Inn.", "Effectiveness");
        foreach (var result in results)
           Console.WriteLine("{0,-20} {1,9:F2} {2,11:F2} {3,15:F2}",  
                          result.Item1, result.Item2, result.Item3, result.Item4);
     }
  
     private static Tuple<string, double, double, double>[] ComputeStatistics(Tuple<string, decimal, int, int>[] pitchers)
     {    
        var list = new List<Tuple<string, double, double, double>>();
        Tuple<string, double, double, double> result;
  
        foreach (var pitcher in pitchers)
        {
           // Decimal portion of innings pitched represents 1/3 of an inning
           double innings = (double) Math.Truncate(pitcher.Item2);
           innings = innings + (((double)pitcher.Item2 - innings) * .33);
           
           double ERA = pitcher.Item4/innings * 9;
           double hitsPerInning = pitcher.Item3/innings;
           double EI = (ERA * 2 + hitsPerInning * 9)/3;
           result = new Tuple<string, double, double, double>
                             (pitcher.Item1, ERA, hitsPerInning, EI);
           list.Add(result);
        }
        return list.ToArray();
     }
  }
  // The example displays the following output;
  //       Pitcher                    ERA   Hits/Inn.   Effectiveness
  //       
  //       McHale, Joe               3.60        0.92            5.16
  //       Paul, Dave                3.24        0.99            5.14
  //       Williams, Mike            4.01        0.95            5.52
  //       Blair, Jack               3.48        0.87            4.93
  //       Henry, Walt               1.93        0.69            3.34
  //       Lee, Adam                 2.95        0.80            4.36
  //       Rohr, Don                 3.74        1.09            5.76
  

  open System
  
  let computeStatistics (pitchers: Tuple<string, decimal, int, int>[]) =
      [| for pitcher in pitchers do
          // Decimal portion of innings pitched represents 1/3 of an inning
          let innings =  truncate (double pitcher.Item2) |> double
          let innings = innings + (double pitcher.Item2 - innings) * 0.33
          
          let ERA = double pitcher.Item4 / innings * 9.
          let hitsPerInning = double pitcher.Item3 / innings
          let EI = (ERA * 2. + hitsPerInning * 9.) / 3.
          Tuple<string, double, double, double>(pitcher.Item1, ERA, hitsPerInning, EI)|]
  
  let pitchers  =  
      [| Tuple.Create("McHale, Joe", 240.1m, 221, 96)
         Tuple.Create("Paul, Dave", 233.1m, 231, 84)
         Tuple.Create("Williams, Mike", 193.2m, 183, 86)
         Tuple.Create("Blair, Jack", 168.1m, 146, 65) 
         Tuple.Create("Henry, Walt", 140.1m, 96, 30)
         Tuple.Create("Lee, Adam", 137.2m, 109, 45)
         Tuple.Create("Rohr, Don", 101.0m, 110, 42) |]
  
  let results = computeStatistics pitchers
  
  // Display the results.
  printfn "%-20s %9s %11s %15s\n" "Pitcher" "ERA" "Hits/Inn." "Effectiveness"
  for result in results do
      printfn $"{result.Item1,-20} {result.Item2,9:F2} {result.Item3,11:F2} {result.Item4,15:F2}"
  
  // The example displays the following output
  //       Pitcher                    ERA   Hits/Inn.   Effectiveness
  //       
  //       McHale, Joe               3.60        0.92            5.16
  //       Paul, Dave                3.24        0.99            5.14
  //       Williams, Mike            4.01        0.95            5.52
  //       Blair, Jack               3.48        0.87            4.93
  //       Henry, Walt               1.93        0.69            3.34
  //       Lee, Adam                 2.95        0.80            4.36
  //       Rohr, Don                 3.74        1.09            5.76
  

  Imports System.Collections.Generic
  
  Module Example
     Public Sub Main()
        Dim pitchers() =  
                 { Tuple.Create("McHale, Joe", 240.1d, 221, 96),
                   Tuple.Create("Paul, Dave", 233.1d, 231, 84), 
                   Tuple.Create("Williams, Mike", 193.2d, 183, 86),
                   Tuple.Create("Blair, Jack", 168.1d, 146, 65), 
                   Tuple.Create("Henry, Walt", 140.1d, 96, 30),
                   Tuple.Create("Lee, Adam", 137.2d, 109, 45),
                   Tuple.Create("Rohr, Don", 101.0d, 110, 42) }
        Dim results() = ComputeStatistics(pitchers)
  
        ' Display the results.
        Console.WriteLine("{0,-20} {1,9} {2,11} {3,15}", "Pitcher", "ERA", "Hits/Inn.", "Effectiveness")
        Console.WriteLine()
        For Each result In results
           Console.WriteLine("{0,-20} {1,9:F2} {2,11:F2} {3,15:F2}",  
                          result.Item1, result.Item2, result.Item3, result.Item4)
        Next
     End Sub
     
     Private Function ComputeStatistics(pitchers() As Tuple(Of String, Decimal, Integer, Integer)) _ 
                                  As Tuple(Of String, Double, Double, Double)()
        Dim list As New List(Of Tuple(Of String, Double, Double, Double))
        Dim result As Tuple(Of String, Double, Double, Double)
  
        For Each pitcher As Tuple(Of String, Decimal, Integer, Integer) In pitchers
           ' Decimal portion of innings pitched represents 1/3 of an inning
           Dim innings As Double = CDbl(Math.Truncate(pitcher.Item2))
           innings = innings + ((pitcher.Item2 - innings) * .33)
           
           Dim ERA As Double = pitcher.Item4/innings * 9
           Dim hitsPerInning As Double = pitcher.Item3/innings
           Dim EI As Double = (ERA * 2 + hitsPerInning * 9)/3
           result = New Tuple(Of String, Double, Double, Double) _
                             (pitcher.Item1, ERA, hitsPerInning, EI)
           list.Add(result) 
        Next
        Return list.ToArray()
     End Function
  End Module
  ' The example displays the following output:
  '       Pitcher                    ERA   Hits/Inn.   Effectiveness
  '       
  '       McHale, Joe               3.60        0.92            5.16
  '       Paul, Dave                3.24        0.99            5.14
  '       Williams, Mike            4.01        0.95            5.52
  '       Blair, Jack               3.48        0.87            4.93
  '       Henry, Walt               1.93        0.69            3.34
  '       Lee, Adam                 2.95        0.80            4.36
  '       Rohr, Don                 3.74        1.09            5.76
  

• Para retornar vários valores de um método sem o uso de out parâmetros (em C#) ou ByRef parâmetros (no Visual Basic). Por exemplo, o exemplo anterior retorna suas estatísticas computadas, juntamente com o nome do arremessador, em uma matriz de Tuple<T1,T2,T3,T4> objetos.

• Para passar vários valores para um método por meio de um único parâmetro. Por exemplo, o Thread.Start(Object) método tem um único parâmetro que permite fornecer um valor para o método que o thread executa na inicialização. Se você fornecer um Tuple<T1,T2,T3,T4> objeto como o argumento do método, poderá fornecer a rotina de inicialização do thread quatro itens de dados.

Confira também

• Tuple
• Tuple<T1>
• Tuple<T1,T2>
• Tuple<T1,T2,T3>
• Tuple<T1,T2,T3,T4,T5>
• Tuple<T1,T2,T3,T4,T5,T6>
• Tuple<T1,T2,T3,T4,T5,T6,T7>
• Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>