Tuple<T1,T2,T3,T4> Kelas

Definisi

Mewakili 4 tuple, atau quadruple.

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
public class Tuple<T1,T2,T3,T4> : IComparable, System.Collections.IStructuralComparable, System.Collections.IStructuralEquatable, System.Runtime.CompilerServices.ITuple
[System.Serializable]
public class Tuple<T1,T2,T3,T4> : IComparable, System.Collections.IStructuralComparable, System.Collections.IStructuralEquatable
type Tuple<'T1, 'T2, 'T3, 'T4> = class
    interface IStructuralComparable
    interface IStructuralEquatable
    interface IComparable
type Tuple<'T1, 'T2, 'T3, 'T4> = class
    interface IStructuralComparable
    interface IStructuralEquatable
    interface IComparable
    interface ITuple
[<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
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

Jenis parameter

T1

Jenis komponen pertama tuple.

T2

Jenis komponen kedua tuple.

T3

Jenis komponen ketiga tuple.

T4

Jenis komponen keempat tuple.

Warisan
Tuple<T1,T2,T3,T4>
Atribut
Penerapan

Keterangan

Tuple adalah struktur data yang memiliki angka dan urutan nilai tertentu. Kelas ini Tuple<T1,T2,T3,T4> mewakili 4 tuple, atau quadruple, yang merupakan tuple yang memiliki empat komponen.

Anda dapat membuat Tuple<T1,T2,T3,T4> instans objek dengan memanggil Tuple<T1,T2,T3,T4> konstruktor atau metode statis Tuple.Create<T1,T2,T3,T4>(T1, T2, T3, T4) . Anda dapat mengambil nilai komponen tuple dengan menggunakan properti instans , , Item1, Item2dan Item3 baca-sajaItem4.

Tuple umumnya digunakan dengan empat cara berbeda:

  • Untuk mewakili satu set data. Misalnya, tuple dapat mewakili rekaman database, dan komponennya dapat mewakili bidang rekaman individual.

  • Untuk menyediakan akses mudah ke, dan manipulasi, himpunan data. Contoh berikut mendefinisikan array Tuple<T1,T2,T3,T4> objek yang berisi nama pitcher baseball, jumlah inning yang mereka pitch, dan jumlah eksekusi yang diperoleh (eksekusi yang mencetak tanpa kesalahan bidang), dan hit yang mereka berikan. Array diteruskan ke ComputeStatistics metode , yang menghitung rata-rata eksekusi yang diperoleh setiap pitcher (jumlah rata-rata eksekusi yang diberikan dalam game sembilan inning), dan jumlah rata-rata hit yang diberikan per bab. Metode ini juga menggunakan dua rata-rata ini untuk menghitung rata-rata efektivitas hipotetis.

    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
    
  • Untuk mengembalikan beberapa nilai dari metode tanpa menggunakan out parameter (dalam C#) atau ByRef parameter (di Visual Basic). Misalnya, contoh sebelumnya mengembalikan statistik komputasinya, bersama dengan nama pitcher, dalam array Tuple<T1,T2,T3,T4> objek.

  • Untuk meneruskan beberapa nilai ke metode melalui satu parameter. Misalnya, Thread.Start(Object) metode ini memiliki satu parameter yang memungkinkan Anda menyediakan satu nilai ke metode yang dijalankan utas saat startup. Jika Anda menyediakan Tuple<T1,T2,T3,T4> objek sebagai argumen metode, Anda dapat menyediakan rutinitas startup utas dengan empat item data.

Konstruktor

Nama Deskripsi
Tuple<T1,T2,T3,T4>(T1, T2, T3, T4)

Menginisialisasi instans baru dari kelas Tuple<T1,T2,T3,T4>.

Properti

Nama Deskripsi
Item1

Mendapatkan nilai komponen pertama objek saat ini Tuple<T1,T2,T3,T4> .

Item2

Mendapatkan nilai komponen kedua objek saat ini Tuple<T1,T2,T3,T4> .

Item3

Mendapatkan nilai komponen ketiga objek saat ini Tuple<T1,T2,T3,T4> .

Item4

Mendapatkan nilai komponen keempat objek saat ini Tuple<T1,T2,T3,T4> .

Metode

Nama Deskripsi
Equals(Object)

Mengembalikan nilai yang menunjukkan apakah objek saat ini Tuple<T1,T2,T3,T4> sama dengan objek tertentu.

GetHashCode()

Mengembalikan kode hash untuk objek saat ini Tuple<T1,T2,T3,T4> .

GetType()

Mendapatkan Type instans saat ini.

(Diperoleh dari Object)
MemberwiseClone()

Membuat salinan dangkal dari Objectsaat ini.

(Diperoleh dari Object)
ToString()

Mengembalikan string yang mewakili nilai instans ini Tuple<T1,T2,T3,T4> .

Implementasi Antarmuka Eksplisit

Nama Deskripsi
IComparable.CompareTo(Object)

Membandingkan objek saat ini Tuple<T1,T2,T3,T4> dengan objek tertentu dan mengembalikan bilangan bulat yang menunjukkan apakah objek saat ini sebelum, sesudah, atau dalam posisi yang sama dengan objek yang ditentukan dalam urutan pengurutan.

IStructuralComparable.CompareTo(Object, IComparer)

Membandingkan objek saat ini Tuple<T1,T2,T3,T4> dengan objek tertentu dengan menggunakan pembanding tertentu dan mengembalikan bilangan bulat yang menunjukkan apakah objek saat ini adalah sebelum, sesudah, atau dalam posisi yang sama dengan objek yang ditentukan dalam urutan pengurutan.

IStructuralEquatable.Equals(Object, IEqualityComparer)

Mengembalikan nilai yang menunjukkan apakah objek saat ini Tuple<T1,T2,T3,T4> sama dengan objek tertentu berdasarkan metode perbandingan yang ditentukan.

IStructuralEquatable.GetHashCode(IEqualityComparer)

Menghitung kode hash untuk objek saat ini Tuple<T1,T2,T3,T4> dengan menggunakan metode komputasi tertentu.

ITuple.Item[Int32]

Mendapatkan nilai elemen yang ditentukan Tuple .

ITuple.Length

Mendapatkan jumlah elemen dalam Tuple.

Metode Ekstensi

Nama Deskripsi
Deconstruct<T1,T2,T3,T4>(Tuple<T1,T2,T3,T4>, T1, T2, T3, T4)

Mendekonstruksi tuple dengan 4 elemen ke dalam variabel terpisah.

ToValueTuple<T1,T2,T3,T4>(Tuple<T1,T2,T3,T4>)

Mengonversi instans Tuple kelas menjadi instans ValueTuple struktur.

Berlaku untuk

Lihat juga