C# Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Class

Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> class is used to create an n-tuple where n = 8 or greater than 8. It represents a tuple that contains eight or more than eight elements in it. we can instantiate a Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> object by calling either the Tuple<T1, T2, T3, T4, T5, T6, T7, TRest>(T1, T2, T3, T4, T5, T6, T7, TRest) constructor or by the static Tuple.Create method. There are some important points mentioned below:

• It implements IStructuralComparable, IStructuralEquatable, and IComparable interfaces.
• It is defined under the System namespace.
• We can create more than eight elements in a tuple with the help of nesting. You can create a nested tuple in the place of the Rest parameter in Tuple<T1, T2, T3, T4, T5, T6, T7, TRest>.
• It represents multiple data into a single data set.
• It allows us to create, manipulate, and access data sets.
• It returns multiple values from a method without using out parameters.
• It allows the passing of multiple values to a method with the help of single parameters.
• It can also store duplicate elements.

Constructor

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

Property

We can retrieve value of Tuple<T1, T2, T3, T4, T5, T6, T7, TRest>(T1, T2, T3, T4, T5, T6, T7, TRest) object by read-only Item<elementNumber> instance property

• Item1: Gets the value of the Tuple object’s first element.
• Item2: Gets the value of the Tuple object’s first element.
• Item3: Gets the value of the Tuple object’s first element.
• Item4: Gets the value of the Tuple object’s first element.
• Item5: Gets the value of the Tuple object’s first element.
• Item6: Gets the value of the Tuple object’s first element.
• Item7: Gets the value of the Tuple object’s first element.
• Rest: Gets the current Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> object’s remaining elements

Example: Creating an 8-tuple using the constructor of the tuple class.

// Using constructor and property 
// of Tuple<T1, T2, T3, T4, 
// T5, T6, T7, TRest> Class
using System;

class Geeks
{
	static public void Main()
	{
		// Creating 8-Tuple using constructor
		Tuple<int, int, int, string, int, string, int, Tuple<int, int>> tuple = new Tuple<int,
		int, int, string, int, string, int, Tuple<int, int>>(79, 34, 67, "Geeks", 44,
		"GeeksforGeeks", 66, new Tuple<int, int>(89, 77));

		// Accessing the values
		Console.WriteLine("Value of the First Component: " + tuple.Item1);
		Console.WriteLine("Value of the Second Component: " + tuple.Item2);
		Console.WriteLine("Value of the Third Component: " + tuple.Item3);
		Console.WriteLine("Value of the Fourth Component: " + tuple.Item4);
		Console.WriteLine("Value of the Fifth Component: " + tuple.Item5);
		Console.WriteLine("Value of the Sixth Component: " + tuple.Item6);
		Console.WriteLine("Value of the Seventh Component: " + tuple.Item7);
		Console.WriteLine("Value of the Eighth Component: " + tuple.Rest);
	}
}

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
Value of the Sixth Component: GeeksforGeeks
Value of the Seventh Component: 66
Value of the Eighth Component: (89, 77)

Methods

Example: Demonstration of Equals() Method

// Using the tuple Equals() method
using System;

class Geeks
{
	static public void Main()
	{
		// Creating 8-Tuple Using constructor
		Tuple<int, int, int, int, int, int, int, Tuple<string>> mytuple1 = 
          new Tuple<int,int, int, int, int, int, int, Tuple<string>>
          	(20, 40, 90, 89, 33, 66, 87, new Tuple<string>("GeeksforGeeks"));

		Tuple<int, int, int, int, int, int, int, Tuple<string>> mytuple2 = 
          new Tuple<int,int, int, int, int, int, int, Tuple<string>>
          	(20, 40, 90, 89, 33, 66, 87, new Tuple<string>("GeeksforGeeks"));

		// Using Equals method
		if (mytuple1.Equals(mytuple2))
			Console.WriteLine("Tuple Matched.");
		else
			Console.WriteLine("Tuple Not Matched.");
	}
}

Tuple Matched.