The
with() method in
org.javatuples is used to instantiate a tuple in a semantically elegant way, with the values given as parameters. This method can be used for any tuple class object of the javatuples library. This method is a static function in each javatuple class and it returns the tuple class object of the called class, with the values initialized by the corresponding values in the arguments.
Syntax: public static <A, B, ..> <em>TupleClass<A, B, ..> with(A a, B b, ..)
Parameters: This method takes
n values as parameters where:
- n- represents the number of values based on the TupleClass (Unit, Pair, etc) used.
- A a- represents the type for 1st value in A and its corresponding value in a.
- B b- represents the type for 2nd value in B and its corresponding value in b.
. . and so on.
Return Value: This method returns the object of
TupleClass, which calls the method, with the values passed as the parameters.
Exceptions: This method throws a
RuntimeException in the following cases:
- When the values passed do not match their expected types in TupleClass
- When the number of values passed are lesser than expected in TupleClass
- When the number of values passed are more than expected in TupleClass
Below programs illustrate the various ways to use with() methods:
Program 1: When the with() method is used correctly, here with Unit class:
Java // Below is a Java program to create // a Unit tuple from with() method import java.util.*; import org.javatuples.Unit; class GfG { public static void main(String[] args) { // Using with() method to instantiate unit object Unit<String> unit = Unit.with("GeeksforGeeks"); System.out.println(unit); } } [GeeksforGeeks]
Program 2: When the values passed
do not match their expected types:
Java // Below is a Java program to create // a Unit tuple from with() method import java.util.*; import org.javatuples.Quartet; class GfG { public static void main(String[] args) { // Using with() method to instantiate unit object Quartet<Integer, String, String, Double> quartet = Quartet.with(Double.valueOf(1), "GeeksforGeeks", "A computer portal", Double.valueOf(20.18)); System.out.println(quartet); } } Exception in thread "main" java.lang.RuntimeException: Uncompilable source code - incompatible types: inference variable A has incompatible bounds equality constraints: java.lang.Integer lower bounds: java.lang.Double at MainClass.GfG.main]
Program 3: When the number of values passed are
lesser than expected:
Java // Below is a Java program to create // a Unit tuple from with() method import java.util.*; import org.javatuples.Quartet; class GfG { public static void main(String[] args) { // Using with() method to instantiate unit object Quartet<Integer, String, String, Double> quartet = Quartet.with(Integer.valueOf(1), "GeeksforGeeks", "A computer portal"); System.out.println(quartet); } } Exception in thread "main" java.lang.RuntimeException: Uncompilable source code - Erroneous sym type: org.javatuples.Quartet.with at MainClass.GfG.main
Program 4: When the number of values passed are
more than expected:
Java // Below is a Java program to create // a Unit tuple from with() method import java.util.*; import org.javatuples.Quartet; class GfG { public static void main(String[] args) { // Using with() method to instantiate unit object Quartet<Integer, String, String, Double> quartet = Quartet.with(Integer.valueOf(1), "GeeksforGeeks", "A computer portal", Double.valueOf(20.18), Integer.valueOf(1)); System.out.println(quartet); } } Exception in thread "main" java.lang.RuntimeException: Uncompilable source code - Erroneous sym type: org.javatuples.Quartet.with at MainClass.GfG.main
Note: Similarly, it can be used with any other JavaTuple Class.
Similar Reads
JavaTuple toList() method
The toList() method in org.javatuples is used to convert the values in TupleClass into a List. This List is of Object type, so that it can take all values. It is inherited from the JavaTuple class. This method can be used to any tuple class object of javatuples library. It returns List formed with t
2 min read
JavaTuples setAtX() method
The setAtX() method in org.javatuples is used to change the value in the existing tuple, at the index X. Since JavaTuples are immutable, hence changing a value in the existing tuple results in a new tuple with the modified value at the index X. It returns the tuple class object of the called class w
2 min read
JavaTuples setKey() method
The setKey() method in org.javatuples is used to set the key of the KeyValue Class object. This method can be used with only KeyValue class object of javatuples library. It returns another KeyValueClassObject with the Key as the element passed as the parameter, and the value from the previous KeyVal
2 min read
JavaTuples add() method
The add() method in org.javatuples is used to add a value to the existing tuple. Since JavaTuples are immutable, hence adding a value to the existing tuple results in a new tuple with one more value. For example, adding a value to Unit tuple results in the formation of a Pair tuple. This method can
3 min read
JavaTuples toString() method
The toString() method in org.javatuples is used to convert the values in TupleClass into a String. This method is inherited from the JavaTuple class. This method can be used to any tuple class object of javatuples library. It returns a String value formed with the values in the TupleClassObject. Met
2 min read
JavaTuples setLabel() method
The setLabel() method in org.javatuples is used to set the label of the LabelValue Class object. This method can be used with only LabelValue class object of javatuples library. It returns another LabelValueClassObject with the Label as the element passed as the parameter, and the value from the pre
2 min read
JavaTuples setValue() method
The setValue() method in org.javatuples is used to set the value in the LabelValueClassObject or KeyValueClassObject. This method can be used with only LabelValue class or KeyValue class of javatuples library. It returns another ClassObject with the value as the element passed as the parameter, and
2 min read
JavaTuple toArray() method
The toArray() method in org.javatuples is used to convert the values in TupleClass into an array of Object type. This method is inherited from the JavaTuple class. This method can be used to any tuple class object of javatuples library. It returns an array of Object type formed with the values in th
2 min read
JavaTuples equal() method
The equals() method in org.javatuples is used to check whether a TupleClass is equal to the TupleClass given as parameter. This method can be used to any tuple class object of javatuples library. It returns a boolean value that is true or false based on the equivalence of that TupleClass with existi
2 min read
JavaTuples addAtX() method
The addAtX() method in org.javatuples is used to add a value to the existing tuple, at an index X. Since JavaTuples are immutable, hence adding a value to the existing tuple results in a new tuple with one more value. For example, adding a value to Unit tuple results in the formation of a Pair tuple
3 min read