Tuple<T1,T2,T3,T4> Класс

Ссылка

Определение

Пространство имен:: System

Сборка:: System.Runtime.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет кортеж из четырех компонентов.

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

Параметры типа

T1

Тип первого компонента кортежа.

T2

Тип второго компонента кортежа.

T3

Тип третьего компонента кортежа.

T4

Тип четвертого компонента кортежа.

Наследование: Object
Tuple<T1,T2,T3,T4>

Атрибуты: SerializableAttribute

Реализации: IStructuralComparable IStructuralEquatable IComparable ITuple

Кортеж — это структура данных, которая имеет определенное число и последовательность значений. Класс Tuple<T1,T2,T3,T4> представляет собой 4 кортежа или четырехкратный кортеж, который представляет собой кортеж с четырьмя компонентами.

Можно создать экземпляр Tuple<T1,T2,T3,T4> объекта, вызвав Tuple<T1,T2,T3,T4> конструктор или статический Tuple.Create<T1,T2,T3,T4>(T1, T2, T3, T4) метод. Значение компонентов кортежа можно получить с помощью свойств экземпляра, доступных только Item1 Item2для чтения, Item3и Item4 экземпляра.

Кортежи обычно используются четырьмя разными способами:

Для представления одного набора данных. Например, кортеж может представлять запись базы данных, а его компоненты могут представлять отдельные поля записи.

Для обеспечения простого доступа к набору данных и управления ими. В следующем примере определяется массив Tuple<T1,T2,T3,T4> объектов, содержащих имена кувшин бейсбола, количество иннингов, которые они разбили, и количество заработанных запусков (запусков, которые забили без ошибок поля) и попаданий, которые они отказались. Массив передается методу ComputeStatistics , который вычисляет среднее время выполнения каждого кувшина (среднее число запусков, отдаваемых в игре с девятью иннингами), а также среднее количество попаданий, отдаваемых на иннинг. Метод также использует эти два средних значения для вычисления гипотетической эффективности среднего.

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

Возврат нескольких значений out из метода без использования параметров (в C#) или ByRef параметров (в Visual Basic). Например, предыдущий пример возвращает вычисляемую статистику вместе с именем кувшина в массиве Tuple<T1,T2,T3,T4> объектов.
Передача нескольких значений в метод через один параметр. Например, Thread.Start(Object) метод имеет один параметр, который позволяет указать одно значение методу, который поток выполняет при запуске. Если вы предоставляете Tuple<T1,T2,T3,T4> объект в качестве аргумента метода, можно указать подпрограмму запуска потока с четырьмя элементами данных.

Конструкторы

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

Инициализирует новый экземпляр класса Tuple<T1,T2,T3,T4>.

Свойства

Item1	Получает значение первого компонента текущего объекта Tuple<T1,T2,T3,T4>.
Item2	Получает значение второго компонента текущего объекта Tuple<T1,T2,T3,T4>.
Item3	Получает значение третьего компонента текущего объекта Tuple<T1,T2,T3,T4>.
Item4	Получает значение четвертого компонента текущего объекта Tuple<T1,T2,T3,T4>.

Методы

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`.

Применяется к