C# | Tuple<T1,T2,T3,T4,T5> Class

The Tuple<T1, T2, T3, T4, T5> class is used to create a 5-tuple or quintuple. It represents a tuple which contains the five elements in it. You can instantiate a Tuple<T1, T2, T3, T4, T5> object by calling either the Tuple<T1, T2, T3, T4, T5>(T1, T2, T3, T4, T5) constructor or by the static Tuple.Create method. You can retrieve the value of the tuple’s elements by using the read-only Item1, Item2, Item3, Item4, and Item5 instance property.

Important Points:

It implements IStructuralComparable, IStructuralEquatable, and IComparable interface.
It defined under System namespace.
It represent multiple data into a single data set.
It allows us to create, manipulate, and access data set.
It returns multiple values from a method without using out parameter.
It allows passing multiple values to a method with the help of single parameters.
It can also store duplicate elements.

Constructor

Constructor	Description
Tuple<T1, T2, T3, T4, T5>(T1, T2, T3, T4, T5)	Initializes a new instance of the Tuple<T1, T2, T3, T4, T5> class.

Property

Property	Description
Item1	Gets the value of the Tuple<T1, T2, T3, T4, T5> object’s first component.
Item2	Gets the value of the current Tuple<T1, T2, T3, T4, T5> object’s second component.
Item3	Gets the value of the current Tuple<T1, T2, T3, T4, T5> object’s third component.
Item4	Gets the value of the current Tuple<T1, T2, T3, T4, T5> object’s fourth component.
Item5	Gets the value of the current Tuple<T1, T2, T3, T4, T5> object’s fifth component.

Example:

// C# progtam to illustrate the constructor 
// and property of Tuple<T1, T2, T3, T4, T5> Class 
using System; 
   
class GFG { 
  
    // Main Method 
    static public void Main () { 
  
        // Creating 5-Tuple 
        // Using Tuple<T1, T2, T3, T4,  
        // T5>(T1, T2, T3, T4, T5) constructor 
        Tuple<int, int, int, string, int>mytuple = new Tuple<int, 
                 int, int, string, int>(79, 34, 67, "Geeks", 44); 
           
        // Accessing the values 
        Console.WriteLine("Value of the First Component: " + mytuple.Item1); 
        Console.WriteLine("Value of the Second Component: " + mytuple.Item2); 
        Console.WriteLine("Value of the Third Component: " + mytuple.Item3); 
        Console.WriteLine("Value of the Fourth Component: " + mytuple.Item4); 
        Console.WriteLine("Value of the Fifth Component: " + mytuple.Item5); 
  
    } 
} 

Output:

Value of the First Component: 79
Value of the Second Component: 34
Value of the Third Component: 67
Value of the Fourth Component: Geeks
Value of the Fifth Component: 44

Methods

Method	Description
Equals(Object)	Returns a value that indicates whether the current Tuple<T1, T2, T3, T4, T5> object is equal to a specified object.
GetHashCode()	Returns the hash code for the current Tuple<T1, T2, T3, T4, T5> object.
GetType()	Gets the Type of the current instance.
MemberwiseClone()	Creates a shallow copy of the current Object.
ToString()	Returns a string that represents the value of this Tuple<T1, T2, T3, T4, T5> instance.

Example:

// C# program to check whether the 
// given tuples are equal or not 
using System; 
  
class GFG { 
  
    // Main method 
    static public void Main() 
    { 
  
        // Creating 5-Tuple 
        // Using Tuple<T1, T2, T3, T4, 
        // T5>(T1, T2, T3, T4, T5) constructor 
        Tuple<int, int, int, int, int> mytuple1 = new Tuple<int, 
                        int, int, int, int>(20, 40, 90, 89, 33); 
  
        Tuple<int, int, int, int, int> mytuple2 = new Tuple<int,  
                        int, int, int, int>(20, 40, 90, 89, 33); 
  
        // Using Equals method 
        if (mytuple1.Equals(mytuple2))  
        { 
            Console.WriteLine("Tuple Matched.."); 
        } 
  
        else 
        { 
            Console.WriteLine("Tuple not Matched.."); 
        } 
    } 
} 

Output:

Tuple Matched..

Reference:

https://docs.microsoft.com/en-us/dotnet/api/system.tuple-5?view=netframework-4.8

My Personal Notes

Constructor

Property

Methods

Recommended Posts: