Implement missing INFO function

Author: RobinvanderVliet

docs/references/function-list-by-category.md

@@ -189,7 +189,7 @@ Excel Function           | PhpSpreadsheet Function
 -------------------------|--------------------------------------
 CELL                     | **Not yet Implemented**
 ERROR.TYPE               | \PhpOffice\PhpSpreadsheet\Calculation\Information\ExcelError::type
-INFO                     | **Not yet Implemented**
+INFO                     | \PhpOffice\PhpSpreadsheet\Calculation\Information\Info::getInfo
 ISBLANK                  | \PhpOffice\PhpSpreadsheet\Calculation\Information\Value::isBlank
 ISERR                    | \PhpOffice\PhpSpreadsheet\Calculation\Information\ErrorValue::isErr
 ISERROR                  | \PhpOffice\PhpSpreadsheet\Calculation\Information\ErrorValue::isError

docs/references/function-list-by-name-compact.md

@@ -299,7 +299,7 @@ IMSUM                    | ENGINEERING           | Engineering\ComplexOperations
 IMTAN                    | ENGINEERING           | Engineering\ComplexFunctions::IMTAN
 INDEX                    | LOOKUP_AND_REFERENCE  | LookupRef\Matrix::index
 INDIRECT                 | LOOKUP_AND_REFERENCE  | LookupRef\Indirect::INDIRECT
-INFO                     | INFORMATION           | **Not yet Implemented**
+INFO                     | INFORMATION           | Information\Info::getInfo
 INT                      | MATH_AND_TRIG         | MathTrig\IntClass::evaluate
 INTERCEPT                | STATISTICAL           | Statistical\Trends::INTERCEPT
 INTRATE                  | FINANCIAL             | Financial\Securities\Rates::interest

docs/references/function-list-by-name.md

@@ -295,7 +295,7 @@ IMSUM                    | CATEGORY_ENGINEERING           | \PhpOffice\PhpSpread
 IMTAN                    | CATEGORY_ENGINEERING           | \PhpOffice\PhpSpreadsheet\Calculation\Engineering\ComplexFunctions::IMTAN
 INDEX                    | CATEGORY_LOOKUP_AND_REFERENCE  | \PhpOffice\PhpSpreadsheet\Calculation\LookupRef\Matrix::index
 INDIRECT                 | CATEGORY_LOOKUP_AND_REFERENCE  | \PhpOffice\PhpSpreadsheet\Calculation\LookupRef\Indirect::INDIRECT
-INFO                     | CATEGORY_INFORMATION           | **Not yet Implemented**
+INFO                     | CATEGORY_INFORMATION           | \PhpOffice\PhpSpreadsheet\Calculation\Information\Info::getInfo
 INT                      | CATEGORY_MATH_AND_TRIG         | \PhpOffice\PhpSpreadsheet\Calculation\MathTrig\IntClass::evaluate
 INTERCEPT                | CATEGORY_STATISTICAL           | \PhpOffice\PhpSpreadsheet\Calculation\Statistical\Trends::INTERCEPT
 INTRATE                  | CATEGORY_FINANCIAL             | \PhpOffice\PhpSpreadsheet\Calculation\Financial\Securities\Rates::interest

src/PhpSpreadsheet/Calculation/FunctionArray.php

@@ -1284,8 +1284,9 @@ class FunctionArray extends CalculationBase
         ],
         'INFO' => [
             'category' => Category::CATEGORY_INFORMATION,
-            'functionCall' => [Functions::class, 'DUMMY'],
+            'functionCall' => [Information\Info::class, 'getInfo'],
             'argumentCount' => '1',
+            'passCellReference' => true,
         ],
         'INT' => [
             'category' => Category::CATEGORY_MATH_AND_TRIG,

src/PhpSpreadsheet/Calculation/Information/Info.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace PhpOffice\PhpSpreadsheet\Calculation\Information;
+
+use PhpOffice\PhpSpreadsheet\Cell\Cell;
+
+class Info
+{
+    /**
+     * INFO.
+     *
+     * Excel Function:
+     *        =INFO(type_text)
+     *
+     * @param mixed $typeText String specifying the type of information to be returned
+     * @param ?Cell $cell Cell from which spreadsheet information is retrieved
+     *
+     * @return string The requested information about the current operating environment
+     */
+    public static function getInfo(mixed $typeText = '', ?Cell $cell = null): string
+    {
+        return match (is_string($typeText) ? strtolower($typeText) : $typeText) {
+            'numfile'   => $cell?->getWorksheetOrNull()?->getParent()?->getSheetCount() ?? 1,
+            'osversion' => 'PHP ' . phpversion(),
+            'recalc'    => 'Automatic',
+            'system'    => 'PHP',
+            default     => ExcelError::VALUE(),
+        };
+    }
+}