Tuple<T1,T2,T3> Třída

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

Tuple.cs

Představuje 3 řazenou kolekci členů nebo trojitou kolekci členů.

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

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

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

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

Parametry typu

T1

Typ první komponenty řazené kolekce členů.

T2

Typ druhé komponenty řazené kolekce členů.

T3

Typ třetí komponenty řazené kolekce členů.

Dědičnost

Object

Tuple<T1,T2,T3>

Implementuje

IStructuralComparable IStructuralEquatable IComparable ITuple

Poznámky

Řazená kolekce členů je datová struktura, která má určitý počet a posloupnost hodnot. Třída Tuple<T1,T2,T3> představuje 3-řazenou kolekci členů nebo trojitou kolekci členů, která má tři součásti.

Objekt lze vytvořit Tuple<T1,T2,T3> instanci voláním Tuple<T1,T2,T3> konstruktoru nebo statické Tuple.Create<T1,T2,T3>(T1, T2, T3) metody. Hodnoty součástí řazené kolekce členů můžete načíst pomocí vlastností jen Item1Item2pro čtení a Item3 instance.

Řazené kolekce členů se běžně používají čtyřmi různými způsoby:

• Představuje jednu sadu dat. Například řazená kolekce členů může představovat záznam databáze a její komponenty mohou představovat jednotlivá pole záznamu.

• Pro zajištění snadného přístupu k datové sadě a manipulaci s nimi. Následující příklad definuje pole Tuple<T1,T2,T3> objektů, které obsahují jména studentů, jejich průměrné skóre testů a počet provedených testů. Matice se předá ComputeStatistics metodě, která vypočítá střední a směrodatnou odchylku skóre testu.

  using System;
  
  public class Example
  {
     public static void Main()
     {
        Tuple<string, double, int>[] scores = 
                      { Tuple.Create("Jack", 78.8, 8),
                        Tuple.Create("Abbey", 92.1, 9), 
                        Tuple.Create("Dave", 88.3, 9),
                        Tuple.Create("Sam", 91.7, 8), 
                        Tuple.Create("Ed", 71.2, 5),
                        Tuple.Create("Penelope", 82.9, 8),
                        Tuple.Create("Linda", 99.0, 9),
                        Tuple.Create("Judith", 84.3, 9) };
        var result = ComputeStatistics(scores);
        Console.WriteLine("Mean score: {0:N2} (SD={1:N2}) (n={2})", 
                          result.Item2, result.Item3, result.Item1);
     }
  
     private static Tuple<int, double, double> ComputeStatistics(Tuple<string, double, int>[] scores) 
     {
        int n = 0;
        double sum = 0;
  
        // Compute the mean.
        foreach (var score in scores)
        {
           n += score.Item3;
           sum += score.Item2 * score.Item3;
        }
        double mean = sum / n;
        
        // Compute the standard deviation.
        double ss = 0;
        foreach (var score in scores)
        {
           ss = Math.Pow(score.Item2 - mean, 2);
        }
        double sd = Math.Sqrt(ss/scores.Length);
        return Tuple.Create(scores.Length, mean, sd);
     }
  }
  // The example displays the following output:
  //       Mean score: 87.02 (SD=0.96) (n=8)
  

  open System
  
  let computeStatistics (scores: Tuple<string, double, int>[]) = 
      let mutable n = 0
      let mutable sum = 0.
  
      // Compute the mean.
      for score in scores do
          n <- n + score.Item3
          sum <- sum + score.Item2 * double score.Item3
      let mean = sum / double n
      
      // Compute the standard deviation.
      let mutable ss = 0.
      for score in scores do
          ss <- (score.Item2 - mean) ** 2.
      let sd = sqrt (ss / double scores.Length)
      Tuple.Create(scores.Length, mean, sd)
  
  let scores = 
      [| Tuple.Create("Jack", 78.8, 8)
         Tuple.Create("Abbey", 92.1, 9) 
         Tuple.Create("Dave", 88.3, 9)
         Tuple.Create("Sam", 91.7, 8) 
         Tuple.Create("Ed", 71.2, 5)
         Tuple.Create("Penelope", 82.9, 8)
         Tuple.Create("Linda", 99.0, 9)
         Tuple.Create("Judith", 84.3, 9) |]
  let result = computeStatistics scores
  printfn $"Mean score: {result.Item2:N2} (SD={result.Item3:N2}) (n={result.Item1})"
  // The example displays the following output:
  //       Mean score: 87.02 (SD=0.96) (n=8)
  

  Module Example
     Public Sub Main()
        Dim scores() = 
                        { Tuple.Create("Jack", 78.8, 8),
                          Tuple.Create("Abbey", 92.1, 9), 
                          Tuple.Create("Dave", 88.3, 9),
                          Tuple.Create("Sam", 91.7, 8), 
                          Tuple.Create("Ed", 71.2, 5),
                          Tuple.Create("Penelope", 82.9, 8),
                          Tuple.Create("Linda", 99.0, 9),
                          Tuple.Create("Judith", 84.3, 9) }
        Dim result = ComputeStatistics(scores)
        Console.WriteLine("Mean score: {0:N2} (SD={1:N2}) (n={2})", 
                          result.Item2, result.Item3, result.Item1)
     End Sub
     
     Private Function ComputeStatistics(scores() As Tuple(Of String, Double, Integer)) _ 
                                  As Tuple(Of Integer, Double, Double)
        Dim n As Integer = 0      
        Dim sum As Double = 0
        
        ' Compute the mean.
        For Each score In scores
           n+= score.Item3 
           sum += score.Item2 * score.Item3
        Next     
        Dim mean As Double = sum / n
  
        ' Compute the standard deviation.
        Dim ss As Double = 0
        For Each score In scores
           ss = Math.Pow(score.Item2 - mean, 2)
        Next
        Dim sd As Double = Math.Sqrt(ss/scores.Length)
        Return Tuple.Create(scores.Length, mean, sd)
     End Function
  End Module
  ' The example displays the following output:
  '       Mean score: 87.02 (SD=0.96) (n=8)
  

• Chcete-li vrátit více hodnot z metody bez použití out parametrů (v jazyce C#) nebo ByRef parametrů (v jazyce Visual Basic). Například předchozí příklad vrátí statistiku souhrnného skóre testu v objektu Tuple<T1,T2,T3> .

• Předání více hodnot metodě prostřednictvím jednoho parametru. Například Thread.Start(Object) metoda má jeden parametr, který umožňuje zadat jednu hodnotu metodě, kterou vlákno spouští při spuštění. Pokud jako argument metody zadáte Tuple<T1,T2,T3> objekt, můžete zadat spouštěcí rutinu vlákna se třemi položkami dat.

Konstruktory

Name	Description
Tuple<T1,T2,T3>(T1, T2, T3)	Inicializuje novou instanci Tuple<T1,T2,T3> třídy.

Vlastnosti

Name	Description
Item1	Získá hodnotu první komponenty aktuálního Tuple<T1,T2,T3> objektu.
Item2	Získá hodnotu druhé komponenty aktuálního Tuple<T1,T2,T3> objektu.
Item3	Získá hodnotu třetí komponenty aktuálního Tuple<T1,T2,T3> objektu.

Metody

Name	Description
Equals(Object)	Vrátí hodnotu, která určuje, zda je aktuální Tuple<T1,T2,T3> objekt roven zadanému objektu.
GetHashCode()	Vrátí kód hash pro aktuální Tuple<T1,T2,T3> objekt.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje hodnotu této Tuple<T1,T2,T3> instance.

Explicitní implementace rozhraní

Name	Description
IComparable.CompareTo(Object)	Porovná aktuální Tuple<T1,T2,T3> objekt se zadaným objektem a vrátí celé číslo, které určuje, zda je aktuální objekt před, za nebo ve stejné pozici jako zadaný objekt v pořadí řazení.
IStructuralComparable.CompareTo(Object, IComparer)	Porovná aktuální Tuple<T1,T2,T3> objekt se zadaným objektem pomocí zadaného porovnávače a vrátí celé číslo, které určuje, zda je aktuální objekt před, za nebo ve stejné pozici jako zadaný objekt v pořadí řazení.
IStructuralEquatable.Equals(Object, IEqualityComparer)	Vrátí hodnotu, která určuje, zda je aktuální Tuple<T1,T2,T3> objekt roven zadanému objektu na základě zadané metody porovnání.
IStructuralEquatable.GetHashCode(IEqualityComparer)	Vypočítá kód hash pro aktuální Tuple<T1,T2,T3> objekt pomocí zadané výpočetní metody.
ITuple.Item[Int32]	Získá hodnotu zadaného Tuple prvku.
ITuple.Length	Získá počet prvků v .Tuple

Metody rozšíření

Name	Description
Deconstruct<T1,T2,T3>(Tuple<T1,T2,T3>, T1, T2, T3)	Dekonstruuje řazenou kolekci členů se 3 prvky do samostatných proměnných.
ToValueTuple<T1,T2,T3>(Tuple<T1,T2,T3>)	Převede instanci Tuple třídy na instanci ValueTuple struktury.

Viz také

• Tuple
• Tuple<T1>
• Tuple<T1,T2>
• Tuple<T1,T2,T3,T4>
• 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>