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 Genérico

Herança

Object

Tuple<T1,T2,T3,T4>

Atributos

SerializableAttribute

Implementações

IStructuralComparable IStructuralEquatable IComparable ITuple

Observações

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

Pode instanciar 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) . Pode obter o valor dos componentes da tupla usando as propriedades de apenas Item1leitura , Item2, Item3, e Item4 instância.

As tuplas são frequentemente usadas de quatro formas diferentes:

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

• Proporcionar fácil acesso e manipulação de um conjunto de dados. O exemplo seguinte define um conjunto de Tuple<T1,T2,T3,T4> objetos que contêm os nomes dos lançadores de basebol, o número de entradas lançadas e o número de corridas merecidas (corridas que marcaram sem erros defensivos) e rebatidas que cederam. O array é passado para o ComputeStatistics método, que calcula a média de corridas merecidas de cada lançador (o número médio de corridas cedidas num jogo de nove entradas) e o número médio de rebatidas concedidas por entrada. O método também utiliza estas duas médias para calcular uma média hipotética de eficácia.

  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
  

• Devolver múltiplos valores de um método sem o uso de parâmetros out (em C#) ou parâmetros ByRef (em Visual Basic). Por exemplo, o exemplo anterior devolve as suas estatísticas calculadas, juntamente com o nome do lançador, numa matriz de Tuple<T1,T2,T3,T4> objetos.

• Passar múltiplos valores a um método através de um único parâmetro. Por exemplo, o Thread.Start(Object) método tem um único parâmetro que permite fornecer um valor ao método que a thread executa no arranque. Se fornecer um Tuple<T1,T2,T3,T4> objeto como argumento de método, pode fornecer a rotina de arranque do thread com quatro itens de dados.

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