Tuple<T1,T2> Osztály

Definíció

Névtér:

System

Szerelvények:

netstandard.dll, System.Runtime.dll

Forrás:

Tuple.cs

Kétfős vagy páros értéket jelöl.

generic <typename T1, typename T2>
public ref class Tuple : IComparable, System::Collections::IStructuralComparable, System::Collections::IStructuralEquatable, System::Runtime::CompilerServices::ITuple

public class Tuple<T1,T2> : IComparable, System.Collections.IStructuralComparable, System.Collections.IStructuralEquatable, System.Runtime.CompilerServices.ITuple

type Tuple<'T1, 'T2> = class
    interface IStructuralComparable
    interface IStructuralEquatable
    interface IComparable
    interface ITuple

Public Class Tuple(Of T1, T2)
Implements IComparable, IStructuralComparable, IStructuralEquatable, ITuple

Típusparaméterek

T1

A rekord első összetevőjének típusa.

T2

A rekord második összetevőjének típusa.

Öröklődés

Object

Tuple<T1,T2>

Megvalósítás

IStructuralComparable IStructuralEquatable IComparable ITuple

Megjegyzések

A rekord egy adatszerkezet, amely meghatározott számú és értéksorozatú. Az Tuple<T1,T2> osztály egy 2-rekordot vagy párot jelöl, amely két összetevőből álló rekord. A kétütemű szerkezet hasonló a KeyValuePair<TKey,TValue> szerkezethez.

Az objektumok példányosításához Tuple<T1,T2> hívja meg a Tuple<T1,T2> konstruktort vagy a statikus Tuple.Create<T1,T2>(T1, T2) metódust. A rekord összetevőinek értékeit lekérheti az írásvédett Item1 és Item2 a példánytulajdonságok használatával.

A csuplokat általában négy különböző módon használják:

• Egyetlen adatkészlet ábrázolása. Egy rekord például egy adatbázisban lévő rekordot jelölhet, összetevői pedig az adott rekord mezőit.

• Az adathalmazokhoz való könnyű hozzáférés és kezelés biztosítása. Az alábbi példa egy objektumtömböt Tuple<T1,T2> határoz meg, amely tartalmazza a tanulók nevét és a hozzájuk tartozó teszteredményeket. Ezután iterálja a tömböt az átlagos tesztpontszám kiszámításához.

  using System;
  
  public class Example
  {
     public static void Main()
     {
        Tuple<string, Nullable<int>>[] scores = 
                      { new Tuple<string, Nullable<int>>("Jack", 78),
                        new Tuple<string, Nullable<int>>("Abbey", 92), 
                        new Tuple<string, Nullable<int>>("Dave", 88),
                        new Tuple<string, Nullable<int>>("Sam", 91), 
                        new Tuple<string, Nullable<int>>("Ed", null),
                        new Tuple<string, Nullable<int>>("Penelope", 82),
                        new Tuple<string, Nullable<int>>("Linda", 99),
                        new Tuple<string, Nullable<int>>("Judith", 84) };
        int number;
        double mean = ComputeMean(scores, out number);
        Console.WriteLine("Average test score: {0:N2} (n={1})", mean, number);
     }
  
     private static double ComputeMean(Tuple<string, Nullable<int>>[] scores, out int n) 
     {
        n = 0;      
        int sum = 0;
        foreach (var score in scores)
        {
           if (score.Item2.HasValue)
           { 
              n += 1;
              sum += score.Item2.Value;
           }
        }     
        if (n > 0)
           return sum / (double) n;
        else
           return 0;
     }
  }
  // The example displays the following output:
  //       Average test score: 87.71 (n=7)
  

  open System
  
  let scores = 
      [| Tuple<string, Nullable<int>>("Jack", 78)
         Tuple<string, Nullable<int>>("Abbey", 92) 
         Tuple<string, Nullable<int>>("Dave", 88)
         Tuple<string, Nullable<int>>("Sam", 91) 
         Tuple<string, Nullable<int>>("Ed", Nullable())
         Tuple<string, Nullable<int>>("Penelope", 82)
         Tuple<string, Nullable<int>>("Linda", 99)
         Tuple<string, Nullable<int>>("Judith", 84) |]
  
  let computeMean (scores: Tuple<string, Nullable<int>>[]) (n: int outref) = 
      n <- 0      
      let mutable sum = 0
      for _, score in scores do
          if score.HasValue then
              n <- n + 1
              sum <- sum + score.Value
      if n > 0 then
          double sum / double n
      else
          0
  
  let mutable number = 0
  let mean = computeMean scores &number
  printfn $"Average test score: {mean:N2} (n={number})"
  // The example displays the following output:
  //       Average test score: 87.71 (n=7)
  

  Module Example
     Public Sub Main()
        Dim scores() As Tuple(Of String, Nullable(Of Integer)) = 
                        { New Tuple(Of String, Nullable(Of Integer))("Jack", 78),
                          New Tuple(Of String, Nullable(Of Integer))("Abbey", 92), 
                          New Tuple(Of String, Nullable(Of Integer))("Dave", 88),
                          New Tuple(Of String, Nullable(Of Integer))("Sam", 91), 
                          New Tuple(Of String, Nullable(Of Integer))("Ed", Nothing),
                          New Tuple(Of String, Nullable(Of Integer))("Penelope", 82),
                          New Tuple(Of String, Nullable(Of Integer))("Linda", 99),
                          New Tuple(Of String, Nullable(Of Integer))("Judith", 84) }
        Dim number As Integer
        Dim mean As Double = ComputeMean(scores, number)
        Console.WriteLine("Average test score: {0:N2} (n={1})", mean, number)
     End Sub
     
     Private Function ComputeMean(scores() As Tuple(Of String, Nullable(Of Integer)), 
                                  ByRef n As Integer) As Double
        n = 0      
        Dim sum As Integer
        For Each score In scores
           If score.Item2.HasValue Then 
              n += 1
              sum += score.Item2.Value
           End If
        Next     
        If n > 0 Then
           Return sum / n
        Else
           Return 0
        End If             
     End Function
  End Module
  ' The example displays the following output:
  '       Average test score: 87.71 (n=7)
  

• Több érték visszaadása egy metódusból out paraméterek használata nélkül (C#-ban) vagy ByRef paraméterek használata nélkül (Visual Basic). Az alábbi példa például egy Tuple<T1,T2> objektumot használ a hányados és az egész szám osztásából eredő maradék visszaadásához.

  using System;
  
  public class Class1
  {
     public static void Main()
     {
        int dividend, divisor;
        Tuple<int, int> result;
        
        dividend = 136945; divisor = 178;
        result = IntegerDivide(dividend, divisor);
        if (result != null)
           Console.WriteLine(@"{0} \ {1} = {2}, remainder {3}", 
                             dividend, divisor, result.Item1, result.Item2);
        else
           Console.WriteLine(@"{0} \ {1} = <Error>", dividend, divisor);
                          
        dividend = Int32.MaxValue; divisor = -2073;
        result = IntegerDivide(dividend, divisor);
        if (result != null)
           Console.WriteLine(@"{0} \ {1} = {2}, remainder {3}", 
                             dividend, divisor, result.Item1, result.Item2);
        else
           Console.WriteLine(@"{0} \ {1} = <Error>", dividend, divisor);
     }
  
     private static Tuple<int, int> IntegerDivide(int dividend, int divisor)
     {
        try {
           int remainder;
           int quotient = Math.DivRem(dividend, divisor, out remainder);
           return new Tuple<int, int>(quotient, remainder);
        }   
        catch (DivideByZeroException) {
           return null;
        }      
     }
  }
  // The example displays the following output:
  //       136945 \ 178 = 769, remainder 63
  //       2147483647 \ -2073 = -1035930, remainder 757
  

  open System
  
  let integerDivide (dividend: int) divisor =
      try
          let quotient, remainder = Math.DivRem(dividend, divisor)
          Tuple<int, int>(quotient, remainder)
      with :? DivideByZeroException ->
          Unchecked.defaultof<Tuple<int, int>>
  
  [<EntryPoint>]
  let main _ =
      let dividend = 136945 
      let divisor = 178
      let result = integerDivide dividend divisor
      if box result <> null then
          printfn $@"{dividend} \ {divisor} = {result.Item1}, remainder {result.Item2}" 
      else
          printfn $@"{dividend} \ {divisor} = <Error>"
                      
      let dividend = Int32.MaxValue 
      let divisor = -2073
      let result = integerDivide dividend divisor
      if box result <> null then
          printfn $@"{dividend} \ {divisor} = {result.Item1}, remainder {result.Item2}" 
      else
          printfn $@"{dividend} \ {divisor} = <Error>"
      0
  // The example displays the following output:
  //       136945 \ 178 = 769, remainder 63
  //       2147483647 \ -2073 = -1035930, remainder 757
  

  Module modMain
     Public Sub Main()
        Dim dividend, divisor As Integer
        Dim result As Tuple(Of Integer, Integer)
        
        dividend = 136945 : divisor = 178
        result = IntegerDivide(dividend, divisor)
        If result IsNot Nothing Then
           Console.WriteLine("{0} \ {1} = {2}, remainder {3}", 
                             dividend, divisor, result.Item1, result.Item2)
        Else
           Console.WriteLine("{0} \ {1} = <Error>", dividend, divisor)
        End If
                          
        dividend = Int32.MaxValue : divisor = -2073
        result = IntegerDivide(dividend, divisor)
        If result IsNot Nothing Then
           Console.WriteLine("{0} \ {1} = {2}, remainder {3}", 
                             dividend, divisor, result.Item1, result.Item2)
        Else
           Console.WriteLine("{0} \ {1} = <Error>", dividend, divisor)
        End If
     End Sub
     
     Private Function IntegerDivide(dividend As Integer, divisor As Integer) As Tuple(Of Integer, Integer)
        Try
           Dim remainder As Integer
           Dim quotient As Integer = Math.DivRem(dividend, divisor, remainder)
           Return New Tuple(Of Integer, Integer)(quotient, remainder)
        Catch e As DivideByZeroException
           Return Nothing
        End Try      
     End Function
  End Module
  ' The example displays the following output:
  '       136945 \ 178 = 769, remainder 63
  '       2147483647 \ -2073 = -1035930, remainder 757
  

• Több érték átadása egy metódusnak egyetlen paraméteren keresztül. A metódus például egyetlen paraméterrel rendelkezik, Thread.Start(Object) amely lehetővé teszi, hogy egy értéket adjon meg a szál indításkor végrehajtott metódusának. Ha metódusargumentumként egy objektumot Tuple<T1,T2> ad meg, a szál indítási rutinját két adatelemet is megadhat.

Konstruktorok

Name	Description
Tuple<T1,T2>(T1, T2)	Inicializálja a Tuple<T1,T2> osztály új példányát.

Tulajdonságok

Name	Description
Item1	Lekéri az aktuális Tuple<T1,T2> objektum első összetevőjének értékét.
Item2	Lekéri az aktuális Tuple<T1,T2> objektum második összetevőjének értékét.

Metódusok

Name	Description
Equals(Object)	Olyan értéket ad vissza, amely jelzi, hogy az aktuális Tuple<T1,T2> objektum egyenlő-e egy adott objektummal.
GetHashCode()	Az aktuális Tuple<T1,T2> objektum kivonatkódját adja vissza.
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	A példány értékét Tuple<T1,T2> képviselő sztringet ad vissza.

Explicit interfész-implementációk

Name	Description
IComparable.CompareTo(Object)	Összehasonlítja az aktuális Tuple<T1,T2> objektumot egy adott objektummal, és egy egész számot ad vissza, amely jelzi, hogy az aktuális objektum a rendezési sorrendben a megadott objektum előtt, után vagy ugyanabban a pozícióban van-e.
IStructuralComparable.CompareTo(Object, IComparer)	Összehasonlítja az aktuális Tuple<T1,T2> objektumot egy megadott objektummal egy megadott összehasonlító használatával, és egy egész számot ad vissza, amely jelzi, hogy az aktuális objektum a rendezési sorrendben a megadott objektum előtt, után vagy ugyanabban a pozícióban van-e.
IStructuralEquatable.Equals(Object, IEqualityComparer)	Olyan értéket ad vissza, amely azt jelzi, hogy az aktuális Tuple<T1,T2> objektum egy adott objektummal egyenlő-e egy megadott összehasonlító módszer alapján.
IStructuralEquatable.GetHashCode(IEqualityComparer)	Kiszámítja az aktuális Tuple<T1,T2> objektum kivonatkódját egy megadott számítási módszerrel.
ITuple.Item[Int32]	Lekéri a megadott Tuple elem értékét.
ITuple.Length	Lekéri a Tuple.

Bővítő metódusok

Name	Description
Deconstruct<T1,T2>(Tuple<T1,T2>, T1, T2)	Két elemet tartalmazó rekordot külön változókra bont.
ToValueTuple<T1,T2>(Tuple<T1,T2>)	Átalakítja az Tuple osztály egy példányát a ValueTuple struktúra egy példányává.

Lásd még

• Tuple
• Tuple<T1>
• Tuple<T1,T2,T3>
• Tuple<T1,T2,T3,T4>
• Tuple<T1,T2,T3,T4,T5>
• Tuple<T1,T2,T3,T4,T5,T6>
• Tuple<T1,T2,T3,T4,T5,T6,T7>
• Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>