Author: saqibkhan

Introduction

The org.javatuples.Quintet class represents a Tuple with five elements.

Class Declaration

Following is the declaration for org.javatuples.Quintet class −

public final class Quintet<A, B, C, D, E>
   extends Tuple
  implements IValue0&lt;A&gt;, IValue1&lt;B&gt;, 
     IValue2&lt;C&gt;, IValue3&lt;D&gt;, IValue4&lt;E&gt;

Learn Java in-depth with real-world projects through our Java certification course. Enroll and become a certified expert to boost your career.

Class Constructor

Class Methods

Similarly setAt1() upto setAt4() set the value at index 1, and so on.

Methods inherite

This class inherits methods from the following classes −

• org.javatuples.Tuple
• Object

Example

Let’s see Quintet Class in action. Here we’ll see how to use various methods.

Create a java class file named TupleTester in C:\>JavaTuples.

File: TupleTester.java

package com.tutorialspoint;
import java.util.ArrayList;
import java.util.List;
import org.javatuples.Quartet;
import org.javatuples.Quintet;
import org.javatuples.Sextet;
import org.javatuples.Triplet;

public class TupleTester {
   public static void main(String args[]){
  Quintet<Integer, Integer, Integer, Integer, Integer> quintet 
     = Quintet.with(5, 6, 7,8,9);
  System.out.println(quintet);
  boolean isPresent = quintet.contains(5);
  System.out.println("5 is present: " + isPresent);
  List<Integer> list = new ArrayList<>();
  list.add(1);
  list.add(2);
  list.add(3);
  list.add(4);
  list.add(5);
  Sextet<Integer, Integer, Integer, Integer, Integer, String> sextet 
     = quintet.add("Test");
  System.out.println(sextet);
  Integer value = quintet.getValue0();
  System.out.println(value);
  Quartet<Integer, Integer, Integer, Integer> quartet = quintet.removeFrom0();
  System.out.println(quartet);
  Quintet<Integer, Integer, Integer, Integer, Integer> quintet1 
     = Quintet.fromCollection(list);   
  System.out.println(quintet1);
   }
}

Verify the result

Compile the classes using javac compiler as follows −

C:\JavaTuples>javac -cp javatuples-1.2.jar ./com/tutorialspoint/TupleTester.java

Now run the TupleTester to see the result −

C:\JavaTuples>java  -cp .;javatuples-1.2.jar com.tutorialspoint.TupleTester

Output

Verify the Output

[5, 6, 7, 8, 9]
5 is present: true
[5, 6, 7, 8, 9, Test]
5
[6, 7, 8, 9]
[1, 2, 3, 4, 5]

Introduction

The org.javatuples.Quartet class represents a Tuple with four elements.

Class Declaration

Following is the declaration for org.javatuples.Quartet class −

public final class Quartet<A, B, C, D>
   extends Tuple
  implements IValue0&lt;A&gt;, IValue1&lt;B&gt;, IValue2&lt;C&gt;, IValue3&lt;D&gt;

Learn Java in-depth with real-world projects through our Java certification course. Enroll and become a certified expert to boost your career.

Class Constructor

Class Methods

Similarly setAt1() upto setAt3() set the value at index 1, and so on.

Methods inherite

This class inherits methods from the following classes −

• org.javatuples.Tuple
• Object

Example

Let’s see Quartet Class in action. Here we’ll see how to use various methods.

Create a java class file named TupleTester in C:\>JavaTuples.

File: TupleTester.java

package com.tutorialspoint;
import java.util.ArrayList;
import java.util.List;
import org.javatuples.Quartet;
import org.javatuples.Quintet;
import org.javatuples.Triplet;

public class TupleTester {
   public static void main(String args[]){
  Quartet<Integer, Integer, Integer, Integer> quartet = Quartet.with(
     5, 6, 7,8
  );
  System.out.println(quartet);
  boolean isPresent = quartet.contains(5);
  System.out.println("5 is present: " + isPresent);
  List<Integer> list = new ArrayList<>();
  list.add(1);
  list.add(2);
  list.add(3);
  list.add(4);
  Quintet<Integer, Integer, Integer, Integer, String> quintet = quartet.add("Test");
  System.out.println(quintet);
  Integer value = quartet.getValue0();
  System.out.println(value);
  Triplet<Integer, Integer, Integer> triplet = quartet.removeFrom0();
  System.out.println(triplet);
  Quartet<Integer, Integer, Integer, Integer> quartet1 = Quartet.fromCollection(list);   
  System.out.println(quartet1);
   }
}

Verify the result

Compile the classes using javac compiler as follows −

C:\JavaTuples>javac -cp javatuples-1.2.jar ./com/tutorialspoint/TupleTester.java

Now run the TupleTester to see the result −

C:\JavaTuples>java  -cp .;javatuples-1.2.jar com.tutorialspoint.TupleTester

Output

Verify the Output

[5, 6, 7, 8]
5 is present: true
[5, 6, 7, 8, Test]
5
[6, 7, 8]
[1, 2, 3, 4]

Introduction

The org.javatuples.Triplet class represents a Tuple with three elements.

Class Declaration

Following is the declaration for org.javatuples.Triplet class −

public final class Triplet<A,B,C>
   extends Tuple
  implements IValue0&lt;A&gt;, IValue1&lt;B&gt;, IValue2&lt;C&gt;

Learn Java in-depth with real-world projects through our Java certification course. Enroll and become a certified expert to boost your career.

Class Constructors

Class Methods

Similarly setAt1() upto setAt2() set the value at index 1 and so on.

Methods inherite

This class inherits methods from the following classes −

• org.javatuples.Tuple
• Object

Example

Let’s see Triplet Class in action. Here we’ll see how to use various methods.

Create a java class file named TupleTester in C:\>JavaTuples.

File: TupleTester.java

package com.tutorialspoint;
import java.util.ArrayList;
import java.util.List;
import org.javatuples.Pair;
import org.javatuples.Quartet;
import org.javatuples.Triplet;

public class TupleTester {
   public static void main(String args[]){
  Triplet<Integer, Integer, Integer> triplet = Triplet.with(5, 6, 7);
  System.out.println(triplet);
  boolean isPresent = triplet.contains(5);
  System.out.println("5 is present: " + isPresent);
  List<Integer> list = new ArrayList<>();
  list.add(1);
  list.add(2);
  list.add(3);
  Quartet<Integer, Integer, Integer, String> quartet = triplet.add("Test");
  System.out.println(quartet);
  Integer value = triplet.getValue0();
  System.out.println(value);
  Pair<Integer, Integer> pair = triplet.removeFrom0();
  System.out.println(pair);
  Triplet<Integer, Integer, Integer> triplet1 = 
     Triplet.fromCollection(list);   
  System.out.println(triplet1);
   }
}

Verify the result

Compile the classes using javac compiler as follows −

C:\JavaTuples>javac -cp javatuples-1.2.jar ./com/tutorialspoint/TupleTester.java

Now run the TupleTester to see the result −

C:\JavaTuples>java  -cp .;javatuples-1.2.jar com.tutorialspoint.TupleTester

Output

Verify the Output

[5, 6, 7]
5 is present: true
[5, 6, 7, Test]
5
[6, 7]
[1, 2, 3]

Introduction

The org.javatuples.Pair class represents a Tuple with two elements.

Class Declaration

Following is the declaration for org.javatuples.Pair class −

public final class Pair<A,B>
   extends Tuple
  implements IValue0&lt;A&gt;, IValue1&lt;B&gt;

Learn Java in-depth with real-world projects through our Java certification course. Enroll and become a certified expert to boost your career.

Class Constructor

Class Methods

Similarly setAt1() set the value at index 1.

Methods inherite

This class inherits methods from the following classes −

• org.javatuples.Tuple
• Object

Example

Let’s see Pair Class in action. Here we’ll see how to use various methods.

Create a java class file named TupleTester in C:\>JavaTuples.

File: TupleTester.java

package com.tutorialspoint;
import java.util.ArrayList;
import java.util.List;
import org.javatuples.Pair;
import org.javatuples.Triplet;
import org.javatuples.Unit;

public class TupleTester {
   public static void main(String args[]){
  Pair<Integer, Integer> pair = Pair.with(5,6);
  System.out.println(pair);
  boolean isPresent = pair.contains(5);
  System.out.println("5 is present: " + isPresent);
  List<Integer> list = new ArrayList<>();
  list.add(1);
  list.add(2);
  Triplet<Integer,Integer, String> triplet = pair.add("Test");
  System.out.println(triplet);
  Integer value = pair.getValue0();
  System.out.println(value);
  Unit<Integer> unit = pair.removeFrom0();
  System.out.println(unit);
  Pair<Integer, Integer> pair1 = Pair.fromCollection(list);   
  System.out.println(pair1);
   }
}

Verify the result

Compile the classes using javac compiler as follows −

C:\JavaTuples>javac -cp javatuples-1.2.jar ./com/tutorialspoint/TupleTester.java

Now run the TupleTester to see the result −

C:\JavaTuples>java  -cp .;javatuples-1.2.jar com.tutorialspoint.TupleTester

Output

Verify the Output

[5, 6]
5 is present: true
[5, 6, Test]
5
[6]
[1, 2]

Introduction

The org.javatuples.Unit class represents a Tuple with single element.

Class declaration

Following is the declaration for org.javatuples.Unit class −

public final class Unit<A>
   extends Tuple
  implements IValue0&lt;A&gt;

Learn Java in-depth with real-world projects through our Java certification course. Enroll and become a certified expert to boost your career.

Class constructors

Class Methods

Methods inherits

This class inherits methods from the following classes −

• org.javatuples.Tuple
• Object

Example

Let’s see Unit Class in action. Here we’ll see how to use various methods.

Create a java class file named TupleTester in C:\>JavaTuples.

File: TupleTester.java

package com.tutorialspoint;
import java.util.ArrayList;
import java.util.List;
import org.javatuples.Pair;
import org.javatuples.Unit;
public class TupleTester {
   public static void main(String args[]){
  Unit<Integer> unit = Unit.with(5);
  System.out.println(unit);
  boolean isPresent = unit.contains(5);
  System.out.println("5 is present: " + isPresent);
  List<Integer> list = new ArrayList<>();
  list.add(1);
  Pair<Integer, String> pair = unit.add("Test");
  System.out.println(pair);
  Integer value = unit.getValue0();
  System.out.println(value);
  Unit<Integer> unit1 = Unit.fromCollection(list);   
  System.out.println(unit1);
   }
}

Verify the result

Compile the classes using javac compiler as follows −

C:\JavaTuples>javac -cp javatuples-1.2.jar ./com/tutorialspoint/TupleTester.java

Now run the TupleTester to see the result −

C:\JavaTuples>java  -cp .;javatuples-1.2.jar com.tutorialspoint.TupleTester

Output

Verify the Output

[5]
5 is present: true
[5, Test]
5
[1]

Each tuple provides utility methods to check their elements in similar fashion as collection.

• contains(element) − checks if element is present or not.
• containsAll(collection) − checks if elements are present or not.
• indexOf(element) − returns the index of first element if present otherwise -1.
• lastIndexOf(element) − returns the index of last element if present otherwise -1.

Pair<String, Integer> pair = Pair.with("Test", Integer.valueOf(5)); 
boolean isPresent = pair.contains("Test");

Example

Let’s see JavaTuples in action. Here we’ll see how to check elements in a tuple.

Create a java class file named TupleTester in C:\>JavaTuples.

File: TupleTester.java

package com.tutorialspoint;
import java.util.List;
import org.javatuples.Quartet;
public class TupleTester {
   public static void main(String args[]){
  Quartet<String, Integer, String, String> quartet = Quartet.with(
     "Test1", Integer.valueOf(5), "Test3", "Test3"
  );
  System.out.println(quartet);
  boolean isPresent = quartet.contains(5);
  System.out.println("5 is present: " + isPresent);
  isPresent = quartet.containsAll(List.of("Test1", "Test3"));   
  System.out.println("Test1, Test3 are present: " + isPresent);
  int indexOfTest3 = quartet.indexOf("Test3");
  System.out.println("First Test3 is present at: " + indexOfTest3);
  int lastIndexOfTest3 = quartet.lastIndexOf("Test3");
  System.out.println("Last Test3 is present at: " + lastIndexOfTest3);
   }
}

Verify the result

Compile the classes using javac compiler as follows −

C:\JavaTuples>javac -cp javatuples-1.2.jar ./com/tutorialspoint/TupleTester.java

Now run the TupleTester to see the result −

C:\JavaTuples>java  -cp .;javatuples-1.2.jar com.tutorialspoint.TupleTester

Output

Verify the Output

[Test1, 5, Test3, Test3]
5 is present: true
Test1, Test3 are present: true
First Test3 is present at: 2
Last Test3 is present at: 3

Each tuple implements Iterable interface and can be iterated in similar fashion as collection.

Pair<String, Integer> pair = Pair.with("Test", Integer.valueOf(5)); 
for(Object object: Pair){
	System.out.println(object);
}

Example

Let’s see JavaTuples in action. Here we’ll see how to iterate tuples.

Create a java class file named TupleTester in C:\>JavaTuples.

File: TupleTester.java

package com.tutorialspoint;
import org.javatuples.Quartet;
import org.javatuples.Triplet;
public class TupleTester {
   public static void main(String args[]){
  Triplet<String, Integer, String> triplet = Triplet.with(
     "Test1", Integer.valueOf(5), "Test2"
  );
  for(Object object: triplet) {
     System.out.print(object + " " );
  }
  System.out.println();
  System.out.println(triplet);
  String[] strArray = new String[] {"a", "b" , "c" , "d"};
  Quartet<String, String, String, String> quartet = Quartet.fromArray(strArray);
  for(Object object: quartet) {
     System.out.print(object + " " );
  }
  System.out.println();
  System.out.println("Quartet:" + quartet);
   }
}

Verify the result

Compile the classes using javac compiler as follows −

C:\JavaTuples>javac -cp javatuples-1.2.jar ./com/tutorialspoint/TupleTester.java

Now run the TupleTester to see the result −

C:\JavaTuples>java  -cp .;javatuples-1.2.jar com.tutorialspoint.TupleTester

Output

Verify the Output

Test1 5 Test2 
[Test1, 5, Test2]
a b c d 
Quartet:[a, b, c, d]

Tuple to List/Array

A tuple can be converted to List/Array but at cost of type safety and converted list is of type List<Object>/Object[].

List<Object> list = triplet.toList();
Object[] array = triplet.toArray();

Collection/Array to Tuple

A collection can be converted to tuple using fromCollection() method and array can be converted to tuple using fromArray() method.

Pair<String, Integer> pair = Pair.fromCollection(list);
Quartet<String,String,String,String> quartet = Quartet.fromArray(array); 

If size of array/collection is different than that of tuple, then IllegalArgumentException will occur.

Exception in thread "main" java.lang.IllegalArgumentException: 
Array must have exactly 4 elements in order to create a Quartet. Size is 5
   at ...	

Example

Let’s see JavaTuples in action. Here we’ll see how to convert tuple to list/array and vice versa.

Create a java class file named TupleTester in C:\>JavaTuples.

File: TupleTester.java

package com.tutorialspoint;
import java.util.List;
import org.javatuples.Quartet;
import org.javatuples.Triplet;
public class TupleTester {
   public static void main(String args[]){
  Triplet<String, Integer, String> triplet = Triplet.with(
     "Test1", Integer.valueOf(5), "Test2"
  );
  List<Object> list = triplet.toList();
  Object[] array = triplet.toArray();
  System.out.println("Triplet:" + triplet);
  System.out.println("List: " + list);  
  System.out.println();
  for(Object object: array) {
     System.out.print(object + " " );
  }
  System.out.println();
  String[] strArray = new String[] {"a", "b" , "c" , "d"};
  Quartet<String, String, String, String> quartet = Quartet.fromArray(strArray);
  System.out.println("Quartet:" + quartet);      
   }
}

Verify the result

Compile the classes using javac compiler as follows −

C:\JavaTuples>javac -cp javatuples-1.2.jar ./com/tutorialspoint/TupleTester.java

Now run the TupleTester to see the result −

C:\JavaTuples>java  -cp .;javatuples-1.2.jar com.tutorialspoint.TupleTester

Output

Verify the Output

Triplet:[Test1, 5, Test2]
List: [Test1, 5, Test2]

Test1 5 Test2 
Quartet:[a, b, c, d]

A tuple has removeAtX() methods to remove value at particular index. For example Triplet class has following methods.

• removeAt0() − remove value at index 0 and return the resulted tuple.
• removeAt1() − remove value at index 1 and return the resulted tuple.
• removeAt2() − remove value at index 2 and return the resulted tuple.

Removing an element returns a new tuple.

Example

Let’s see JavaTuples in action. Here we’ll see how to remove value in a tuple.

Create a java class file named TupleTester in C:\>JavaTuples.

File: TupleTester.java

package com.tutorialspoint;
import org.javatuples.Pair;
import org.javatuples.Triplet;
public class TupleTester {
   public static void main(String args[]){
  Triplet<String, Integer, String> triplet = Triplet.with(
     "Test1", Integer.valueOf(5), "Test2"
  );
  Pair<String, Integer> pair = triplet.removeFrom2();
  System.out.println("Triplet:" + triplet);
  System.out.println("Pair: " + pair);  
   }
}

Verify the result

Compile the classes using javac compiler as follows −

C:\JavaTuples>javac -cp javatuples-1.2.jar ./com/tutorialspoint/TupleTester.java

Now run the TupleTester to see the result −

C:\JavaTuples>java  -cp .;javatuples-1.2.jar com.tutorialspoint.TupleTester

Output

Verify the Output

Triplet:[Test1, 5, Test2]
Pair: [Test1, 5]

A tuple has add() method at the end of a tuple and it changes the type of tuple as well. For example adding a element to Triplet tuple will convert it to a Quartet tuple.

Quartet<String,String,String,String> quartet = triplet.add("Test");

A tuple has addAtX() methods as well to add a position at particular index starting from 0.

Quartet<String,String,String,String> quartet = triplet.addAt1("Test");

A tuple can add more than one elements using addAtX() methods.

Quartet<String,String,String,String> quartet = pair.addAt1("Test1", "Test2");

A tuple can add a tuple as well using addAtX() methods.

Quartet<String,String,String,String> quartet = pair.addAt1(pair1);

Example

Let’s see JavaTuples in action. Here we’ll see how to add values in a tuple using various ways.

Create a java class file named TupleTester in C:\>JavaTuples.

File: TupleTester.java

package com.tutorialspoint;
import org.javatuples.Pair;
import org.javatuples.Quartet;
import org.javatuples.Quintet;
import org.javatuples.Triplet;
public class TupleTester {
   public static void main(String args[]){
  Pair<String, Integer> pair = Pair.with("Test", Integer.valueOf(5));   
  Triplet<String, Integer, String> triplet = pair.add("Test2");
  Quartet<String, String, Integer, String> quartet = triplet.addAt1("Test1");
  Quintet<String, Integer, String, String, Integer> quintet = triplet.add(pair);
  System.out.println("Pair: " + pair);
  System.out.println("Triplet:" + triplet);
  System.out.println("Quartet:" + quartet);
  System.out.println("Quintet:" + quintet);     
   }
}

Verify the result

Compile the classes using javac compiler as follows −

C:\JavaTuples>javac -cp javatuples-1.2.jar ./com/tutorialspoint/TupleTester.java

Now run the TupleTester to see the result −

C:\JavaTuples>java  -cp .;javatuples-1.2.jar com.tutorialspoint.TupleTester

Output

Verify the Output

Pair: [Test, 5]
Triplet:[Test, 5, Test2]
Quartet:[Test, Test1, 5, Test2]
Quintet:[Test, 5, Test2, Test, 5]