Additional unit tests, including for differently sized row/row vectors and column/column vectors to ensure that correctly dimensioned results are returned

Author: MarkBaker

src/PhpSpreadsheet/Calculation/MathTrig.php

@@ -301,9 +301,9 @@ public static function FLOORPRECISE($number, $significance = 1)
      * @see MathTrig\IntClass::evaluate()
      *      Use the evaluate() method in the MathTrig\IntClass class instead
      *
-     * @param float $number Number to cast to an integer
+     * @param array|float $number Number to cast to an integer
      *
-     * @return int|string Integer value, or a string containing an error
+     * @return array|int|string Integer value, or a string containing an error
      */
     public static function INT($number)
     {

src/PhpSpreadsheet/Calculation/MathTrig/IntClass.php

@@ -2,10 +2,13 @@
 
 namespace PhpOffice\PhpSpreadsheet\Calculation\MathTrig;
 
+use PhpOffice\PhpSpreadsheet\Calculation\ArrayEnabled;
 use PhpOffice\PhpSpreadsheet\Calculation\Exception;
 
 class IntClass
 {
+    use ArrayEnabled;
+
     /**
      * INT.
      *
@@ -14,12 +17,18 @@ class IntClass
      * Excel Function:
      *        INT(number)
      *
-     * @param float $number Number to cast to an integer
+     * @param array|float $number Number to cast to an integer, or can be an array of numbers
      *
-     * @return int|string Integer value, or a string containing an error
+     * @return array|string Integer value, or a string containing an error
+     *         If an array of numbers is passed as the argument, then the returned result will also be an array
+     *            with the same dimensions
      */
     public static function evaluate($number)
     {
+        if (is_array($number)) {
+            return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $number);
+        }
+
         try {
             $number = Helpers::validateNumericNullBool($number);
         } catch (Exception $e) {

tests/PhpSpreadsheetTests/Calculation/Functions/MathTrig/IntTest.php

@@ -2,6 +2,8 @@
 
 namespace PhpOffice\PhpSpreadsheetTests\Calculation\Functions\MathTrig;
 
+use PhpOffice\PhpSpreadsheet\Calculation\Calculation;
+
 class IntTest extends AllSetupTeardown
 {
     /**
@@ -27,4 +29,25 @@ public function providerINT(): array
     {
         return require 'tests/data/Calculation/MathTrig/INT.php';
     }
+
+    /**
+     * @dataProvider providerIntArray
+     */
+    public function testIntArray(array $expectedResult, string $array): void
+    {
+        $calculation = Calculation::getInstance();
+
+        $formula = "=INT({$array})";
+        $result = $calculation->_calculateFormulaValue($formula);
+        self::assertEqualsWithDelta($expectedResult, $result, 1.0e-14);
+    }
+
+    public function providerIntArray(): array
+    {
+        return [
+            'row vector' => [[[-2, 0, 0]], '{-1.5, 0, 0.3}'],
+            'column vector' => [[[-2], [0], [0]], '{-1.5; 0; 0.3}'],
+            'matrix' => [[[-2, 0], [0, 12]], '{-1.5, 0; 0.3, 12.5}'],
+        ];
+    }
 }

tests/PhpSpreadsheetTests/Calculation/Functions/MathTrig/RoundTest.php

@@ -90,11 +90,21 @@ public function providerRoundArray(): array
                 '{0.14527, 1.37250, -931.68290, 3.14159265}',
                 '{1, 2, 3, 4}',
             ],
+            'Two different size row vectors' => [
+                [[0.1, 1.37]],
+                '{0.14527, 1.37250, -931.68290, 3.14159265}',
+                '{1, 2}',
+            ],
             'Two column vectors' => [
                 [[0.1], [1.37], [-931.683], [3.1416]],
                 '{0.14527; 1.37250; -931.68290; 3.14159265}',
                 '{1; 2; 3; 4}',
             ],
+            'Two different sized column vectors' => [
+                [[0.1], [1.37]],
+                '{0.14527; 1.37250}',
+                '{1; 2; 3; 4}',
+            ],
         ];
     }
 }