英語で読む

次の方法で共有


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

定義

4 つ組、すなわちクオドループルを表します。

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

型パラメーター

T1

組の 1 番目のコンポーネントの型。

T2

組の 2 番目のコンポーネントの型。

T3

組の 3 番目のコンポーネントの型。

T4

組の 4 番目のコンポーネントの型。

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

注釈

タプルは、特定の数と値のシーケンスを持つデータ構造です。 このクラスは Tuple<T1,T2,T3,T4> 4 タプル (4 組) を表します。これは、4 つのコンポーネントを持つタプルです。

コンストラクターまたは静的Tuple.Create<T1,T2,T3,T4>(T1, T2, T3, T4)メソッドをTuple<T1,T2,T3,T4>呼び出Tuple<T1,T2,T3,T4>すことで、オブジェクトをインスタンス化できます。 タプルのコンポーネントの値は、読み取り専用Item1プロパティ、インスタンス Item2Item3プロパティ、およびItem4インスタンス プロパティを使用して取得できます。

タプルは、一般的に次の 4 つの方法で使用されます。

  • 1 つのデータ セットを表す。 たとえば、タプルはデータベース レコードを表し、そのコンポーネントはレコードの個々のフィールドを表すことができます。

  • データ セットへの簡単なアクセスと操作を提供します。 次の例では、野球投手の Tuple<T1,T2,T3,T4> 名前、投球したイニングの数、獲得した実行数 (フィールド エラーなしで得点したラン)、および彼らがあきらめたヒットを含むオブジェクトの配列を定義します。 配列がメソッドに ComputeStatistics 渡され、各投手の獲得したラン平均 (9 回の試合で与えられた平均実行数) と、1 回あたりの平均ヒット数が計算されます。 また、この方法では、これら 2 つの平均を使用して、仮説的な有効性の平均を計算します。

    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
    
  • パラメーター (C# では) またはByRefパラメーター (Visual Basic) を使用outせずに、メソッドから複数の値を返すには。 たとえば、前の例では、計算された統計情報とピッチャーの名前をオブジェクトの Tuple<T1,T2,T3,T4> 配列で返します。

  • 1 つのパラメーターを使用して複数の値をメソッドに渡す。 たとえば、 Thread.Start(Object) このメソッドには、起動時にスレッドが実行するメソッドに 1 つの値を指定できる 1 つのパラメーターがあります。 メソッド引数としてオブジェクトを Tuple<T1,T2,T3,T4> 指定する場合は、スレッドのスタートアップ ルーチンに 4 つのデータ項目を指定できます。

コンストラクター

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

Tuple<T1,T2,T3,T4> クラスの新しいインスタンスを初期化します。

プロパティ

Item1

現在の Tuple<T1,T2,T3,T4> オブジェクトの 1 番目のコンポーネントの値を取得します。

Item2

現在の Tuple<T1,T2,T3,T4> オブジェクトの 2 番目のコンポーネントの値を取得します。

Item3

現在の Tuple<T1,T2,T3,T4> オブジェクトの 3 番目のコンポーネントの値を取得します。

Item4

現在の Tuple<T1,T2,T3,T4> オブジェクトの 4 番目のコンポーネントの値を取得します。

メソッド

Equals(Object)

現在の Tuple<T1,T2,T3,T4> オブジェクトが、指定されたオブジェクトと等しいかどうかを示す値を返します。

GetHashCode()

現在の Tuple<T1,T2,T3,T4> オブジェクトのハッシュ コードを返します。

GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
ToString()

この Tuple<T1,T2,T3,T4> インスタンスの値を表す文字列を返します。

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

IComparable.CompareTo(Object)

現在の Tuple<T1,T2,T3,T4> オブジェクトと指定したオブジェクトを比較して、現在のオブジェクトが、並べ替え順序において、指定したオブジェクトの前後または同じ位置のいずれにあるかを示す整数を返します。

IStructuralComparable.CompareTo(Object, IComparer)

指定された比較子を使用して現在の Tuple<T1,T2,T3,T4> オブジェクトと指定されたオブジェクトを比較し、並べ替え順序において、現在のオブジェクトの位置が指定されたオブジェクトの前になるか、後ろになるか、同じになるかを示す整数を返します。

IStructuralEquatable.Equals(Object, IEqualityComparer)

指定された比較メソッドに基づいて、現在の Tuple<T1,T2,T3,T4> オブジェクトが指定したオブジェクトと等しいかどうかを示す値を返します。

IStructuralEquatable.GetHashCode(IEqualityComparer)

指定した計算メソッドを使用して、現在の Tuple<T1,T2,T3,T4> オブジェクトのハッシュ コードを計算します。

ITuple.Item[Int32]

指定した Tuple 要素の値を取得します。

ITuple.Length

Tuple にある要素の数を取得します。

拡張メソッド

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

4 要素を持つタプルを別個の変数に分解します。

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

Tuple クラスのインスタンスを ValueTuple 構造体のインスタンスに変換します。

適用対象

こちらもご覧ください