C#のTuple＜T1, T2＞クラスとは？ペア（2つ組）の基本と使い方を実例で解説

Tuple<T1, T2>クラスとは

C#のTuple<T1, T2>クラスは、2つの要素を持つタプル（2-tuple、通称「ペア」）を表すクラスです。タプルとは、複数の要素を順序付けてひとまとめに扱えるデータ構造のことを指します。

Tuple<T1, T2>クラスは、主に以下のような場面で活用されます。

• データセットへの簡単なアクセス
• データセットの容易な操作
• 単一のデータセットとしての表現
• メソッドから複数の値を返したい場合
• メソッドへ複数の値を渡したい場合

主なプロパティ

Tuple<T1, T2>クラスには、格納された各要素にアクセスするための2つのプロパティが用意されています。

• Item1 ― 現在のTuple<T1, T2>オブジェクトの1番目の要素の値を取得します。

• Item2 ― 現在のTuple<T1, T2>オブジェクトの2番目の要素の値を取得します。

サンプルコード1：文字列型のペアを作成する

まずは、string型の値を2つ持つ2つ組（ペア）を実装する例を見てみましょう。

using System;
public class Demo {
   public static void Main(string[] args) {
      Tuple<string,string> tuple = new Tuple<string,string>("jack", "steve");
      Console.WriteLine("Value = " + tuple.Item1);
      if (tuple.Item1 == "jack") {
         Console.WriteLine("Exists: Tuple Value = " +tuple.Item1);
      }
      if (tuple.Item2 == "david") {
         Console.WriteLine("Exists: Tuple Value = " +tuple.Item2);
      }
   }
}

出力結果

上記のコードを実行すると、次のような出力が得られます。

Value = jack
Exists: Tuple Value = jack

この例では、Item1に"jack"、Item2に"steve"が格納されています。Item1の値が"jack"と一致したため条件分岐内の出力が表示されましたが、Item2は"david"ではないため、2つ目のif文の中身は実行されていません。

サンプルコード2：異なる型を組み合わせる

Tuple<T1, T2>は、異なる型同士を組み合わせることもできます。次の例では、int型とstring型を持つペアを作成しています。

using System;
public class Demo {
   public static void Main(string[] args) {
      Tuple<int,string> tuple = new Tuple<int,string>(20, "steve");
      Console.WriteLine("Value = " + tuple.Item1);
      if (tuple.Item1 == 20) {
         Console.WriteLine("Exists: Tuple Value = " +tuple.Item1);
      }
      if (tuple.Item2 == "david") {
         Console.WriteLine("Exists: Tuple Value = " +tuple.Item2);
      }
   }
}

出力結果

上記のコードを実行すると、次のような出力が得られます。

Value = 20
Exists: Tuple Value = 20

このように、Tuple<T1, T2>を使えば、IDと名前のように関連性のある2つの値を、ひとつのオブジェクトとして簡潔に扱うことができます。