Initial work enabling Excel function implementations for handling arrays as arguments when used in "array formulae". (#2562)

* Initial work enabling Excel function implementations for handling arrays as aguments when used in "array formulae".

So far:
 - handling for single argument functions
 - for functions where only one of the arguments is an array (a matrix or a row/column vector)
 - for when there are two array arguments, and one is a row vector, the other a column vector
 - for when there are either 2 row vectors, or 2 column vectors
 - for a matrix and either a row or column vector 

Will work ok, as long as there are no more than two array arguments; still need to identify the logic to apply when there are more than two arrays; or there are two that aren't an already supported row vector/column vector pairing (ie two matrices).

* Throw an exception if we have three or more array arguments (after flattening) passed to a supported function until we can identify the abstruse non-euclidian logic behind how Excel handles building, using and presenting those n-dimensional result arrays

* Implement array arguments for the DATE() function so that we can verify that paired arrays/vectors work with functions that support more than 2 arguments

* Implement array arguments for the many of the Math/Trig functions

* Update change log
This commit is contained in:
Mark Baker
2022-02-09 15:12:54 +01:00
committed by GitHub
parent 0ff0187f1f
commit 291ea88a6c
63 changed files with 2339 additions and 220 deletions
@@ -2,6 +2,8 @@
namespace PhpOffice\PhpSpreadsheetTests\Calculation\Functions\MathTrig;
use PhpOffice\PhpSpreadsheet\Calculation\Calculation;
class SqrtPiTest extends AllSetupTeardown
{
/**
@@ -30,4 +32,25 @@ class SqrtPiTest extends AllSetupTeardown
{
return require 'tests/data/Calculation/MathTrig/SQRTPI.php';
}
/**
* @dataProvider providerSqrtPiArray
*/
public function testSqrtPiArray(array $expectedResult, string $array): void
{
$calculation = Calculation::getInstance();
$formula = "=SQRTPI({$array})";
$result = $calculation->_calculateFormulaValue($formula);
self::assertEqualsWithDelta($expectedResult, $result, 1.0e-12);
}
public function providerSqrtPiArray(): array
{
return [
'row vector' => [[[5.317361552716, 6.2665706865775, 8.6832150546992]], '{9, 12.5, 24}'],
'column vector' => [[[5.3173615527166], [6.2665706865775], [8.6832150546992]], '{9; 12.5; 24}'],
'matrix' => [[[5.3173615527166, 6.2665706865775], [8.6832150546992, 14.1796308072441]], '{9, 12.5; 24, 64}'],
];
}
}