C# 元组 Tuple

• 元组
• • 创建元组
  • 访问元组元素
  • 命名元组元素
  • 元组的类型
  • 使用元组作为方法返回值
  • 解构
  • • 解构元组的基本用法
    • 解构部分元组
    • 解构方法

      元组

      在C#中，元组（Tuple）是一种数据结构，它允许你将多个值组合成一个单一的对象。 元组在处理多个返回值或临时组合几个相关数据时非常有用。 从C# 7.0开始，元组得到了语言级别的支持，提供了一种轻量级的、不需要显式定义类型的组合数据的方式。

      创建元组

      你可以使用括号 () 来创建元组，并在括号内提供要组合的值。 元组中的每个值可以是不同的类型。

      var tuple = (1, "Hello", 3.14);
      

      上面的代码创建了一个包含三个元素的元组，分别是整数1，字符串"Hello"和浮点数3.14。

      访问元组元素

      你可以使用 Item1、Item2、Item3 等属性来访问元组中的各个元素。

      int number = tuple.Item1; // 1
      string text = tuple.Item2; // "Hello"
      double pi = tuple.Item3; // 3.14
      

      命名元组元素

      你还可以在创建元组时为每个元素指定一个名称，这使得代码更具可读性。

      var namedTuple = (Number: 1, Text: "Hello", Pi: 3.14);
      

      然后，你可以使用这些名称来访问元组中的元素。

      int number = namedTuple.Number; // 1
      string text = namedTuple.Text; // "Hello"
      double pi = namedTuple.Pi; // 3.14
      

      元组的类型

      元组有一个隐式的类型，例如(int, string, double) 。 如果你想要为元组指定一个显式类型，可以使用 ValueTuple。

      ValueTuple typedTuple = 
      	(1, "Hello", 3.14);
      

      使用元组作为方法返回值

      元组经常被用作方法的返回值，以便返回多个值。

      public (int Max, int Min) FindMaxAndMin(int[] numbers)
      {
          int max = numbers[0];
          int min = numbers[0];
          foreach (var number in numbers)
          {
              if (number > max) max = number;
              if (number < min) min = number;
          }
          return (max, min);
      }
      

      在这个例子中， 方法FindMaxAndMin返回一个包含最大值和最小值的元组。

      元组是C#中一个非常有用的特性，它们提供了一种简便的方式来处理多个相关联的值，而无需创建新的复杂类型。 不过，需要注意的是，元组通常用于临时组合数据，如果数据结构需要长期存在或具有更复杂的逻辑，则可能需要考虑使用更正式的类或结构体。

      ---

      解构

      在C#中，解构（Deconstruct）是一种将元组中的元素分别赋值给单独的变量的操作。 这个过程允许你轻松地从元组中提取值，而不需要逐个访问每个元素。 C# 7.0及以后的版本支持对元组进行解构。

      解构元组的基本用法

      下面是一个简单的例子，展示了如何解构一个元组：

      var tuple = (Number: 1, Text: "Hello", Pi: 3.14);
      // 使用解构来提取元组中的值
      (int number, string text, double pi) = tuple;
      Console.WriteLine(number); // 输出: 1
      Console.WriteLine(text);   // 输出: "Hello"
      Console.WriteLine(pi);     // 输出: 3.14
      

      在这个例子中，我们创建了一个命名元组 tuple，然后使用解构语法将其中的值分别赋给了 number、text 和 pi 三个变量。

      解构部分元组

      你也可以只解构元组中的一部分元素，忽略其他元素：

      var tuple = (Number: 1, Text: "Hello", Pi: 3.14);
      // 只解构元组中的第一个和第三个元素
      (int number, _, double pi) = tuple;
      Console.WriteLine(number); // 输出: 1
      Console.WriteLine(pi);     // 输出: 3.14
      

      在这个例子中，我们使用下划线 _ 来忽略元组中的第二个元素。

      解构方法

      你可以在自定义类型中实现 Deconstruct 方法，使得这些类型的实例也可以被解构。 例如：

      public class Person
      {
          public string FirstName { get; }
          public string LastName { get; }
          public Person(string firstName, string lastName)
          {
              FirstName = firstName;
              LastName = lastName;
          }
          // 实现 Deconstruct 方法
          public void Deconstruct(out string firstName, out string lastName)
          {
              firstName = FirstName;
              lastName = LastName;
          }
      }
      var person = new Person("John", "Doe");
      // 解构 Person 对象
      (string firstName, string lastName) = person;
      Console.WriteLine(firstName); // 输出: "John"
      Console.WriteLine(lastName);  // 输出: "Doe"
      

      在这个例子中，Person 类实现了 Deconstruct 方法，这使得你可以像解构元组一样解构 Person 对象。

      解构是C#中一个非常有用的特性，它提供了一种简洁的方式来从元组或其他对象中提取多个值，从而提高了代码的可读性和便利性。