Fix

Author: Hardvan

src/main/java/com/thealgorithms/matrix/PrintAMatrixInSpiralOrder.java

@@ -3,17 +3,41 @@
 import java.util.ArrayList;
 import java.util.List;
 
+/**
+ * Utility class to print a matrix in spiral order.
+ * <p>
+ * Given a 2D array (matrix), this class provides a method to return the
+ * elements
+ * of the matrix in spiral order, starting from the top-left corner and moving
+ * clockwise.
+ * </p>
+ *
+ * @author Sadiul Hakim (https://github.com/sadiul-hakim)
+ */
 public class PrintAMatrixInSpiralOrder {
+
     /**
-     * Search a key in row and column wise sorted matrix
+     * Returns the elements of the given matrix in spiral order.
+     *
+     * @param matrix the 2D array to traverse in spiral order
+     * @param row    the number of rows in the matrix
+     * @param col    the number of columns in the matrix
+     * @return a list containing the elements of the matrix in spiral order
      *
-     * @param matrix matrix to be searched
-     * @param row    number of rows matrix has
-     * @param col    number of columns matrix has
-     * @author Sadiul Hakim : https://github.com/sadiul-hakim
+     *         <p>
+     *         Example:
+     *
+     *         <pre>
+     * int[][] matrix = {
+     *   {1, 2, 3},
+     *   {4, 5, 6},
+     *   {7, 8, 9}
+     * };
+     * print(matrix, 3, 3) returns [1, 2, 3, 6, 9, 8, 7, 4, 5]
+     *         </pre>
+     *         </p>
      */
     public List<Integer> print(int[][] matrix, int row, int col) {
-
         // r traverses matrix row wise from first
         int r = 0;
         // c traverses matrix column wise from first

src/main/java/com/thealgorithms/others/PrintAMatrixInSpiralOrder.java

@@ -1,4 +1,4 @@
-package com.thealgorithms.others;
+package com.thealgorithms.matrix;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
 
@@ -66,4 +66,18 @@ void testMatrixWithNegativeNumbers() {
         List<Integer> expected = Arrays.asList(-1, -2, -4, -3);
         assertEquals(expected, spiralPrinter.print(matrix, 2, 2));
     }
+
+    @Test
+    void testLargeSquareMatrix() {
+        int[][] matrix = {{3, 4, 5, 6, 7}, {8, 9, 10, 11, 12}, {14, 15, 16, 17, 18}, {23, 24, 25, 26, 27}, {30, 31, 32, 33, 34}};
+        List<Integer> expected = Arrays.asList(3, 4, 5, 6, 7, 12, 18, 27, 34, 33, 32, 31, 30, 23, 14, 8, 9, 10, 11, 17, 26, 25, 24, 15, 16);
+        assertEquals(expected, spiralPrinter.print(matrix, 5, 5));
+    }
+
+    @Test
+    void testSingleRowWithTwoElements() {
+        int[][] matrix = {{2, 2}};
+        List<Integer> expected = Arrays.asList(2, 2);
+        assertEquals(expected, spiralPrinter.print(matrix, 1, 2));
+    }
 }