Tuple<T1,T2,T3,T4> クラス

定義

4 タプル、すなわちクオドループルを表します。Represents a 4-tuple, or 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
type Tuple<'T1, 'T2, 'T3, 'T4> = class
    interface IStructuralEquatable
    interface IStructuralComparable
    interface IComparable
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

型パラメーター

T1

組の 1 番目のコンポーネントの型。The type of the tuple's first component.

T2

組の 2 番目のコンポーネントの型。The type of the tuple's second component.

T3

組の 3 番目のコンポーネントの型。The type of the tuple's third component.

T4

組の 4 番目のコンポーネントの型。The type of the tuple's fourth component.

継承
Tuple<T1,T2,T3,T4>
属性
実装

注釈

組は、特定の数と値のシーケンスを持つデータ構造です。A tuple is a data structure that has a specific number and sequence of values. Tuple<T1,T2,T3,T4> クラスは、4つのタプル (4 つの要素を持つタプル) を表します。The Tuple<T1,T2,T3,T4> class represents a 4-tuple, or quadruple, which is a tuple that has four components.

Tuple<T1,T2,T3,T4> コンストラクターまたは静的 Tuple.Create<T1,T2,T3,T4>(T1, T2, T3, T4) メソッドを呼び出すことによって、Tuple<T1,T2,T3,T4> オブジェクトをインスタンス化できます。You can instantiate a Tuple<T1,T2,T3,T4> object by calling either the Tuple<T1,T2,T3,T4> constructor or the static Tuple.Create<T1,T2,T3,T4>(T1, T2, T3, T4) method. タプルのコンポーネントの値を取得するには、読み取り専用の Item1Item2Item3、および Item4 インスタンスの各プロパティを使用します。You can retrieve the value of the tuple's components by using the read-only Item1, Item2, Item3, and Item4 instance properties.

組は、主に次の4つの方法で使用されます。Tuples are commonly used in four different ways:

  • データの1つのセットを表す場合は。To represent a single set of data. たとえば、組はデータベースレコードを表すことができ、そのコンポーネントはレコードの個々のフィールドを表すことができます。For example, a tuple can represent a database record, and its components can represent individual fields of the record.

  • データセットに簡単にアクセスして操作できるようにするため。To provide easy access to, and manipulation of, a data set. 次の例では Tuple<T1,T2,T3,T4> オブジェクトの配列を定義しています。これには、野球ピッチャーの名前、イニングの数、および獲得された実行の数 (フィールディングエラーのないスコアが付けられた実行)、およびそれらが発生したヒット数が含まれます。The following example defines an array of Tuple<T1,T2,T3,T4> objects that contain the names of baseball pitchers, the number of innings they pitched, and the number of earned runs (runs that scored without fielding errors), and hits that they gave up. 配列は ComputeStatistics メソッドに渡されます。このメソッドは、各水差しの獲得された実行平均 (回ゲームで与えられた平均実行数) と回あたりの平均ヒット数を計算します。The array is passed to the ComputeStatistics method, which calculates each pitcher's earned run average (the average number of runs given up in a nine-inning game), and the average number of hits given up per inning. また、この2つの平均値を使用して、仮定の有効性平均を計算します。The method also uses these two averages to compute a hypothetical effectiveness average.

    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
    
    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
    
  • out パラメーター (でC#は) または ByRef パラメーター (Visual Basic) を使用せずに、メソッドから複数の値を返す場合は。To return multiple values from a method without the use of out parameters (in C#) or ByRef parameters (in Visual Basic). たとえば、前の例では、Tuple<T1,T2,T3,T4> オブジェクトの配列に、計算された統計情報と、水差しの名前を返します。For example, the previous example returns its computed statistics, along with the name of the pitcher, in an array of Tuple<T1,T2,T3,T4> objects.

  • 1つのパラメーターを使用して複数の値をメソッドに渡す場合は。To pass multiple values to a method through a single parameter. たとえば、Thread.Start(Object) メソッドには、起動時にスレッドが実行するメソッドに1つの値を指定できる1つのパラメーターがあります。For example, the Thread.Start(Object) method has a single parameter that lets you supply one value to the method that the thread executes at startup. メソッドの引数として Tuple<T1,T2,T3,T4> オブジェクトを指定する場合は、スレッドのスタートアップルーチンに4つのデータ項目を指定できます。If you supply a Tuple<T1,T2,T3,T4> object as the method argument, you can supply the thread's startup routine with four items of data.

コンストラクター

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

Tuple<T1,T2,T3,T4> クラスの新しいインスタンスを初期化します。Initializes a new instance of the Tuple<T1,T2,T3,T4> class.

プロパティ

Item1

現在の Tuple<T1,T2,T3,T4> オブジェクトの 1 番目のコンポーネントの値を取得します。Gets the value of the current Tuple<T1,T2,T3,T4> object's first component.

Item2

現在の Tuple<T1,T2,T3,T4> オブジェクトの 2 番目のコンポーネントの値を取得します。Gets the value of the current Tuple<T1,T2,T3,T4> object's second component.

Item3

現在の Tuple<T1,T2,T3,T4> オブジェクトの 3 番目のコンポーネントの値を取得します。Gets the value of the current Tuple<T1,T2,T3,T4> object's third component.

Item4

現在の Tuple<T1,T2,T3,T4> オブジェクトの 4 番目のコンポーネントの値を取得します。Gets the value of the current Tuple<T1,T2,T3,T4> object's fourth component.

メソッド

Equals(Object)

現在の Tuple<T1,T2,T3,T4> オブジェクトが、指定されたオブジェクトと等しいかどうかを示す値を返します。Returns a value that indicates whether the current Tuple<T1,T2,T3,T4> object is equal to a specified object.

GetHashCode()

現在の Tuple<T1,T2,T3,T4> オブジェクトのハッシュ コードを返します。Returns the hash code for the current Tuple<T1,T2,T3,T4> object.

GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
ToString()

この Tuple<T1,T2,T3,T4> インスタンスの値を表す文字列を返します。Returns a string that represents the value of this Tuple<T1,T2,T3,T4> instance.

明示的なインターフェイスの実装

IComparable.CompareTo(Object)

現在の Tuple<T1,T2,T3,T4> オブジェクトと指定したオブジェクトを比較して、現在のオブジェクトが、並べ替え順序において、指定したオブジェクトの前後または同じ位置のいずれにあるかを示す整数を返します。Compares the current Tuple<T1,T2,T3,T4> object to a specified object and returns an integer that indicates whether the current object is before, after, or in the same position as the specified object in the sort order.

IStructuralComparable.CompareTo(Object, IComparer)

指定された比較子を使用して現在の Tuple<T1,T2,T3,T4> オブジェクトと指定されたオブジェクトを比較し、並べ替え順序において、現在のオブジェクトの位置が指定されたオブジェクトの前になるか、後ろになるか、同じになるかを示す整数を返します。Compares the current Tuple<T1,T2,T3,T4> object to a specified object by using a specified comparer and returns an integer that indicates whether the current object is before, after, or in the same position as the specified object in the sort order.

IStructuralEquatable.Equals(Object, IEqualityComparer)

指定された比較メソッドに基づいて、現在の Tuple<T1,T2,T3,T4> オブジェクトが指定したオブジェクトと等しいかどうかを示す値を返します。Returns a value that indicates whether the current Tuple<T1,T2,T3,T4> object is equal to a specified object based on a specified comparison method.

IStructuralEquatable.GetHashCode(IEqualityComparer)

指定した計算メソッドを使用して、現在の Tuple<T1,T2,T3,T4> オブジェクトのハッシュ コードを計算します。Calculates the hash code for the current Tuple<T1,T2,T3,T4> object by using a specified computation method.

ITuple.Item[Int32]

指定した Tuple 要素の値を取得します。Gets the value of the specified Tuple element.

ITuple.Length

Tuple にある要素の数を取得します。Gets the number of elements in the Tuple.

拡張メソッド

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

4 要素を持つタプルを別個の変数に分解します。Deconstructs a tuple with 4 elements into separate variables.

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

Tuple クラスのインスタンスを ValueTuple 構造体のインスタンスに変換します。Converts an instance of the Tuple class to an instance of the ValueTuple structure.

適用対象

こちらもご覧ください