Tuple

Author: deepak-malik

README.md

@@ -39,7 +39,7 @@ Below topics/problems are covered as of now.
 - [X] [Associative Array](../master/src/com/deepak/data/structures/Arrays/AssociativeArray.java)
 - [ ] Sparse Array
 - [X] [Pair](../master/src/com/deepak/data/structures/Arrays/Pair.java)
-- [ ] Tuple
+- [X] [Tuple](../master/src/com/deepak/data/structures/Arrays/Tuple.java)
 - [X] [ArrayList Implementation](../master/src/com/deepak/data/structures/Arrays/CustomArrayList.java)
 
 **3. LinkedList** 

src/com/deepak/data/structures/Arrays/Tuple.java

@@ -0,0 +1,79 @@
+/**
+ * Data-Structures-In-Java
+ * Tuple.java
+ */
+package com.deepak.data.structures.Arrays;
+
+/**
+ * Tuple class is an extension of Pair
+ * NOTE : Tuple can have any number of elements.
+ * We are implementing this class as a Triplet for now
+ * 
+ * @author Deepak
+ *
+ * @param <L>
+ * @param <M>
+ * @param <R>
+ */
+public class Tuple<L, M , R> {
+
+/* Since Tuple as well is a immutable data structure,
+ * All the elements are marked as final */
+private final L left;
+private final M middle;
+private final R right;
+
+/**
+ * Constructor
+ * 
+ * @param left
+ * @param middle
+ * @param right
+ */
+public Tuple(L left, M middle, R right) {
+super();
+this.left = left;
+this.middle = middle;
+this.right = right;
+}
+
+/**
+ * Method to create a new Tuple
+ * 
+ * @param left
+ * @param middle
+ * @param right
+ * @return {@link Tuple<L, M, R>}
+ */
+public static <L, M, R> Tuple<L, M, R> of(final L left, final M middle, final R right) {
+return new Tuple<L, M, R>(left, middle, right);
+}
+
+/**
+ * Method to get Left
+ * 
+ * @return {@link L}
+ */
+public L getLeft() {
+return left;
+}
+
+/**
+ * Method to get Middle
+ * 
+ * @return {@link M}
+ */
+public M getMiddle() {
+return middle;
+}
+
+/**
+ * Method to get Right
+ * 
+ * @return {@link R}
+ */
+public R getRight() {
+return right;
+}
+
+}

test/com/deepak/data/structures/Arrays/TupleTest.java

@@ -0,0 +1,36 @@
+/**
+ * Data-Structures-In-Java
+ * TupleTest.java
+ */
+package com.deepak.data.structures.Arrays;
+
+import org.junit.Assert;
+import org.junit.Test;
+
+/**
+ * Test cases for Tuple
+ * 
+ * @author Deepak
+ */
+public class TupleTest {
+
+/**
+ * Method to test Tuple
+ */
+@Test
+public void testTuple() {
+/* Create Tuple with two possible ways */
+Tuple<String, String, String> tuple1 = new Tuple<>("A", "B", "C");
+Tuple<String, String, String> tuple2 = Tuple.of("A", "B", "C");
+Assert.assertEquals(tuple1.getLeft(), tuple2.getLeft());
+Assert.assertEquals(tuple1.getMiddle(), tuple2.getMiddle());
+Assert.assertEquals(tuple1.getRight(), tuple2.getRight());
+
+/* Create a Tuple with null values */
+Tuple<String, String, String> tuple3 = new Tuple<>(null, null, null);
+Assert.assertEquals(tuple3.getLeft(), null);
+Assert.assertEquals(tuple3.getMiddle(), null);
+Assert.assertEquals(tuple3.getRight(), null);
+}
+
+}