Not only does it reduce the risk of typos; but at some point in the future, ExcelError values will be an object rather than a string, and we won't then need to update all the tests.\n - Don't over-complicate test code by testing happy and unhappy paths in the same test.\n\nThis makes it easier to see exactly what is being tested when reviewing the PR. I want to be able to see it in the PR, not have to hunt in other unchanged classes to see what the test is doing.\n\n## How to release\n\n1. Complete CHANGELOG.md and commit\n2. Create an annotated tag\n 1. `git tag -a 1.2.3`\n 2. Tag subject must be the version number, eg: `1.2.3`\n 3. Tag body must be a copy-paste of the changelog entries.\n3. Push the tag with `git push --tags`, GitHub Actions will create a GitHub release automatically, and the release details will automatically be sent to packagist.\n4. By default, Github removes markdown headings in the Release Notes. You can either edit to restore these, or, probably preferably, change the default comment character on your system - `git config core.commentChar \";\"`.\n\n> **Note:** Tagged releases are made from the `master` branch. Only in an emergency should a tagged release be made from the `release` branch. (i.e. cherry-picked hot-fixes.) However, there are 4 branches which have been updated to apply security patches, and those may be tagged if future security updates are needed.\n- 1.30.x (no further updates aside from security patches, including code changes needed for Php 8.5 compatibility)\n- 2.1.x (no further updates aside from security patches, including code changes needed for Php 8.5 compatibility)\n- 2.4.x\n- 3.10.x\n" }, { "path": "LICENSE", "content": "MIT License\n\nCopyright (c) 2019-2026 PhpSpreadsheet Authors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n" }, { "path": "README.md", "content": "# PhpSpreadsheet\n\n[](https://github.com/PHPOffice/PhpSpreadsheet/actions)\n[](https://coveralls.io/github/PHPOffice/PhpSpreadsheet?branch=master)\n[](https://packagist.org/packages/phpoffice/phpspreadsheet)\n[](https://packagist.org/packages/phpoffice/phpspreadsheet)\n[](https://packagist.org/packages/phpoffice/phpspreadsheet)\n[](https://gitter.im/PHPOffice/PhpSpreadsheet)\n\nPhpSpreadsheet is a library written in pure PHP and offers a set of classes that\nallow you to read and write various spreadsheet file formats such as Excel and LibreOffice Calc.\n\nThis is the master branch, and is maintained for security and bug fixes.\n\n## PHP Version Support\n\nLTS: For maintained branches, support for PHP versions will only be maintained for a period of six months beyond the\n[end of life](https://www.php.net/supported-versions) of that PHP version.\n\nCurrently the required PHP minimum version is PHP __8.1__, and we [will support that version](https://www.php.net/supported-versions.php) until 30th June 2026.\n\nSee the `composer.json` for other requirements.\n\n## Installation\n\nSee the [install instructions](https://phpspreadsheet.readthedocs.io/en/latest/#installation).\n\n## Documentation\n\nRead more about it, including install instructions, in the [official documentation](https://phpspreadsheet.readthedocs.io). Or check out the [API documentation](https://phpoffice.github.io/PhpSpreadsheet).\n\nPlease ask your support questions on [StackOverflow](https://stackoverflow.com/questions/tagged/phpspreadsheet), or have a quick chat on [Gitter](https://gitter.im/PHPOffice/PhpSpreadsheet).\n\n## Patreon\n\nI am now running a [Patreon](https://www.patreon.com/MarkBaker) to support the work that I do on PhpSpreadsheet.\n\nSupporters will receive access to articles about working with PhpSpreadsheet, and how to use some of its more advanced features.\n\nPosts already available to Patreon supporters:\n - The Dating Game\n - A look at how MS Excel (and PhpSpreadsheet) handle date and time values.\n- Looping the Loop\n - Advice on Iterating through the rows and cells in a worksheet.\n\nAnd for Patrons at levels actively using PhpSpreadsheet:\n - Behind the Mask\n - A look at Number Format Masks.\n\nThe Next Article (currently Work in Progress):\n - Formula for Success\n - How to debug formulae that don't produce the expected result.\n\n\nMy aim is to post at least one article each month, taking a detailed look at some feature of MS Excel and how to use that feature in PhpSpreadsheet, or on how to perform different activities in PhpSpreadsheet.\n\nPlanned posts for the future include topics like:\n - Tables\n - Structured References\n - AutoFiltering\n - Array Formulae\n - Conditional Formatting\n - Data Validation\n - Value Binders\n - Images\n - Charts\n\nAfter a period of six months exclusive to Patreon supporters, articles will be incorporated into the public documentation for the library.\n\n## PHPExcel vs PhpSpreadsheet ?\n\nPhpSpreadsheet is the next version of PHPExcel. It breaks compatibility to dramatically improve the code base quality (namespaces, PSR compliance, use of latest PHP language features, etc.).\n\nBecause all efforts have shifted to PhpSpreadsheet, PHPExcel will no longer be maintained. All contributions for PHPExcel, patches and new features, should target PhpSpreadsheet `master` branch.\n\nDo you need to migrate? There is [an automated tool](/docs/topics/migration-from-PHPExcel.md) for that.\n\n## License\n\nPhpSpreadsheet is licensed under [MIT](https://github.com/PHPOffice/PhpSpreadsheet/blob/master/LICENSE).\n" }, { "path": "bin/check-phpdoc-types.php", "content": "#!/usr/bin/env php\ngenerateLocales();\n" }, { "path": "bin/pre-commit", "content": "#!/bin/bash\n\npass=true\n\nfiles=$(git diff --cached --name-only --diff-filter=ACMR | grep -E '\\.(php|phtml)$')\nif [ \"$files\" != \"\" ]; then\n\n # Run php syntax check before commit\n while read -r file; do\n php -l \"$file\"\n if [ $? -ne 0 ]; then\n pass=false\n fi\n done <<< \"$files\"\n\n # Run php-cs-fixer validation before commit\n echo \"$files\" | xargs ./vendor/bin/php-cs-fixer fix --diff --config .php-cs-fixer.dist.php\n if [ $? -ne 0 ]; then\n pass=false\n fi\n\n # Automatically add files that may have been fixed by php-cs-fixer\n echo \"$files\" | xargs git add\nfi\n\n# Check PHPDoc types\n./bin/check-phpdoc-types.php\nif [ $? -ne 0 ]; then\n pass=false\nfi\n\nif $pass; then\n exit 0\nelse\n echo \"\"\n echo \"PRE-COMMIT HOOK FAILED:\"\n echo \"Code style validation failed. Please fix errors and try committing again.\"\n exit 1\nfi\n" }, { "path": "composer.json", "content": "{\n \"name\": \"phpoffice/phpspreadsheet\",\n \"description\": \"PHPSpreadsheet - Read, Create and Write Spreadsheet documents in PHP - Spreadsheet engine\",\n \"keywords\": [\n \"PHP\",\n \"OpenXML\",\n \"Excel\",\n \"xlsx\",\n \"xls\",\n \"ods\",\n \"gnumeric\",\n \"spreadsheet\"\n ],\n \"config\": {\n \"platform\": {\n \"php\" : \"8.1.99\"\n },\n \"process-timeout\": 600,\n \"sort-packages\": true,\n \"allow-plugins\": {\n \"dealerdirect/phpcodesniffer-composer-installer\": true\n }\n },\n \"homepage\": \"https://github.com/PHPOffice/PhpSpreadsheet\",\n \"type\": \"library\",\n \"license\": \"MIT\",\n \"authors\": [\n {\n \"name\": \"Maarten Balliauw\",\n \"homepage\": \"https://blog.maartenballiauw.be\"\n },\n {\n \"name\": \"Mark Baker\",\n \"homepage\": \"https://markbakeruk.net\"\n },\n {\n \"name\": \"Franck Lefevre\",\n \"homepage\": \"https://rootslabs.net\"\n },\n {\n \"name\": \"Erik Tilt\"\n },\n {\n \"name\": \"Adrien Crivelli\"\n },\n {\n \"name\": \"Owen Leibman\"\n }\n ],\n \"scripts\": {\n \"check\": [\n \"php bin/check-phpdoc-types.php\",\n \"phpcs samples/ src/ tests/ --report=checkstyle\",\n \"phpcs samples/ src/ tests/ --standard=PHPCompatibility --runtime-set testVersion 8.0- --exclude=PHPCompatibility.Variables.ForbiddenThisUseContexts -n\",\n \"php-cs-fixer fix --ansi --dry-run --diff\",\n \"phpstan analyse --ansi --memory-limit=2048M\",\n \"phpunit --color=always\"\n ],\n \"style\": [\n \"phpcs samples/ src/ tests/ --report=checkstyle\",\n \"php-cs-fixer fix --ansi --dry-run --diff\"\n ],\n \"fix\": [\n \"phpcbf samples/ src/ tests/ --report=checkstyle\",\n \"php-cs-fixer fix\"\n ],\n \"versions\": [\n \"phpcs samples/ src/ tests/ --standard=PHPCompatibility --runtime-set testVersion 8.0- --exclude=PHPCompatibility.Variables.ForbiddenThisUseContexts -n\"\n ]\n },\n \"require\": {\n \"php\": \"^8.1\",\n \"ext-ctype\": \"*\",\n \"ext-dom\": \"*\",\n \"ext-fileinfo\": \"*\",\n \"ext-filter\": \"*\",\n \"ext-gd\": \"*\",\n \"ext-iconv\": \"*\",\n \"ext-libxml\": \"*\",\n \"ext-mbstring\": \"*\",\n \"ext-simplexml\": \"*\",\n \"ext-xml\": \"*\",\n \"ext-xmlreader\": \"*\",\n \"ext-xmlwriter\": \"*\",\n \"ext-zip\": \"*\",\n \"ext-zlib\": \"*\",\n \"composer/pcre\": \"^1||^2||^3\",\n \"maennchen/zipstream-php\": \"^2.1 || ^3.0\",\n \"markbaker/complex\": \"^3.0\",\n \"markbaker/matrix\": \"^3.0\",\n \"psr/simple-cache\": \"^1.0 || ^2.0 || ^3.0\"\n },\n \"require-dev\": {\n \"ext-intl\": \"*\",\n \"dealerdirect/phpcodesniffer-composer-installer\": \"dev-main\",\n \"dompdf/dompdf\": \"^2.0 || ^3.0\",\n \"friendsofphp/php-cs-fixer\": \"^3.2\",\n \"mitoteam/jpgraph\": \"^10.5\",\n \"mpdf/mpdf\": \"^8.1.1\",\n \"phpcompatibility/php-compatibility\": \"^9.3\",\n \"phpstan/phpstan\": \"^1.1 || ^2.0\",\n \"phpstan/phpstan-deprecation-rules\": \"^1.0 || ^2.0\",\n \"phpstan/phpstan-phpunit\": \"^1.0 || ^2.0\",\n \"phpunit/phpunit\": \"^10.5\",\n \"squizlabs/php_codesniffer\": \"^3.7\",\n \"tecnickcom/tcpdf\": \"^6.5\"\n },\n \"suggest\": {\n \"ext-intl\": \"PHP Internationalization Functions, required for NumberFormat Wizard and StringHelper::setLocale()\",\n \"mpdf/mpdf\": \"Option for rendering PDF with PDF Writer\",\n \"dompdf/dompdf\": \"Option for rendering PDF with PDF Writer\",\n \"tecnickcom/tcpdf\": \"Option for rendering PDF with PDF Writer\",\n \"mitoteam/jpgraph\": \"Option for rendering charts, or including charts with PDF or HTML Writers\"\n },\n \"autoload\": {\n \"psr-4\": {\n \"PhpOffice\\\\PhpSpreadsheet\\\\\": \"src/PhpSpreadsheet\"\n }\n },\n \"autoload-dev\": {\n \"psr-4\": {\n \"PhpOffice\\\\PhpSpreadsheetTests\\\\\": \"tests/PhpSpreadsheetTests\",\n \"PhpOffice\\\\PhpSpreadsheetInfra\\\\\": \"infra\"\n }\n }\n}\n" }, { "path": "docs/extra/extra.css", "content": "/* Make the huge table always visible */\ntable.features-cross-reference {\n overflow: visible !important;\n}\n.rst-content table.features-cross-reference.docutils th,\n.rst-content table.features-cross-reference.docutils td {\n background-color: white;\n}\n\n/* https://github.com/mkdocs/mkdocs/discussions/3035#discussioncomment-7237037 */\n.wy-table-responsive table td, .wy-table-responsive table th {\n white-space: normal !important;\n}\n.wy-table-responsive {\n overflow : visible !important;\n}\n\n/* https://github.com/readthedocs/sphinx_rtd_theme/issues/295#issuecomment-455226058 */\n.wy-nav-content {max-width: none;}\n" }, { "path": "docs/extra/extrajs.js", "content": "document.addEventListener(\"DOMContentLoaded\", function() {\n document.querySelectorAll(\"table\").forEach(function(table) {\n table.classList.add(\"docutils\");\n });\n});" }, { "path": "docs/faq.md", "content": "# Frequently asked questions\n\n## There seems to be a problem with character encoding...\n\nIt is necessary to use UTF-8 encoding for all texts in PhpSpreadsheet.\nIf the script uses different encoding then you can convert those texts\nwith PHP's `iconv()` or `mb_convert_encoding()` functions.\n\n## Fatal error: Allowed memory size of xxx bytes exhausted (tried to allocate yyy bytes) in zzz on line aaa\n\nPhpSpreadsheet holds an \"in memory\" representation of a spreadsheet, so\nit is susceptible to PHP's memory limitations. The memory made available\nto PHP can be increased by editing the value of the `memory_limit`\ndirective in your `php.ini` file, or by using\n`ini_set('memory_limit', '128M')` within your code.\n\nSome Readers and Writers are faster than others, and they also use\ndiffering amounts of memory.\n\n## Protection on my worksheet is not working?\n\nWhen you make use of any of the worksheet protection features (e.g. cell\nrange protection, prohibiting deleting rows, ...), make sure you enable\nworksheet security. This can for example be done like this:\n\n```php\n$spreadsheet->getActiveSheet()->getProtection()->setSheet(true);\n```\n\n## Feature X is not working with Reader\\_Y / Writer\\_Z\n\nNot all features of PhpSpreadsheet are implemented in all of the Reader\n/ Writer classes. This is mostly due to underlying libraries not\nsupporting a specific feature or not having implemented a specific\nfeature.\n\nFor example autofilter is not implemented in PEAR\nSpreadsheet\\_Excel\\_writer, which is the base of our Xls writer.\n\nWe are slowly building up a list of features, together with the\ndifferent readers and writers that support them, in the [features cross\nreference](./references/features-cross-reference.md).\n\n## Formulas don't seem to be calculated in Excel2003 using compatibility pack?\n\nThis is normal behaviour of the compatibility pack, `Xlsx` displays this\ncorrectly. Use `\\PhpOffice\\PhpSpreadsheet\\Writer\\Xls` if you really need\ncalculated values, or force recalculation in Excel2003.\n\n## Setting column width is not 100% accurate\n\nTrying to set column width, I experience one problem. When I open the\nfile in Excel, the actual width is 0.71 less than it should be.\n\nThe short answer is that PhpSpreadsheet uses a measure where padding is\nincluded. See [how to set a column's width](./topics/recipes.md#setting-a-columns-width)\nfor more details.\n\n## I cannot serialize or json_encode my Spreadsheet\n\nNo, you can't. Consider the Spreadsheet object as a PHP resource, which cannot be serialized.\n" }, { "path": "docs/index.md", "content": "# Welcome to PhpSpreadsheet's documentation\n\n\n\nPhpSpreadsheet is a library written in pure PHP and offers a set of classes that\nallow you to read and write various spreadsheet file formats such as Excel and LibreOffice Calc.\n\n## File formats supported\n\n|Format |Reading|Writing|\n|--------------------------------------------|:-----:|:-----:|\n|Open Document Format/OASIS (.ods) | ✓ | ✓ |\n|Office Open XML (.xlsx) Excel 2007 and above| ✓ | ✓ |\n|BIFF 8 (.xls) Excel 97 and above | ✓ | ✓ |\n|BIFF 5 (.xls) Excel 95 | ✓ | |\n|SpreadsheetML (.xml) Excel 2003 | ✓ | |\n|Gnumeric | ✓ | |\n|HTML | ✓ | ✓ |\n|SYLK | ✓ | |\n|CSV | ✓ | ✓ |\n|PDF (using either the TCPDF, Dompdf or mPDF libraries, which need to be installed separately)| | ✓ |\n\nNote - reading or writing certain aspects of a spreadsheet may not be supported in all formats. For more details, please consult\n[Features Cross-reference](./references/features-cross-reference.md).\n\n# Getting started\n\n## Software requirements\n\nPHP version 8.1 or newer to develop using PhpSpreadsheet. Other requirements, such as PHP extensions, are enforced by\ncomposer. See the `require` section of [the composer.json file](https://github.com/PHPOffice/PhpSpreadsheet/blob/master/composer.json)\nfor details.\n\n### PHP version support\n\nLTS: Support for PHP versions will only be maintained for a period of six months beyond the\n[end of life of that PHP version](https://www.php.net/eol.php).\n\nCurrently, the required PHP minimum version is __PHP 8.1__, and we [will support that version](https://www.php.net/eol.php) until June 2026.\n\nSupport for PHP versions will only be maintained for a period of six months beyond the\n[end of life](https://www.php.net/supported-versions) of that PHP version.\n\nSee the `composer.json` for other requirements.\n\n## Installation\n\nUse [composer](https://getcomposer.org) to install PhpSpreadsheet into your project:\n\n```sh\ncomposer require phpoffice/phpspreadsheet\n```\n\nOr also download the documentation and samples if you plan to use them (note that `git` must be in your path for this to work):\n\n```sh\ncomposer require phpoffice/phpspreadsheet --prefer-source\n```\n\nIf you are building your installation on a development machine that is on a different PHP version to the server where it\nwill be deployed, or if your PHP CLI version is different from your run-time such as `php-fpm` or Apache's `mod_php`,\nthen you might want to configure composer for that.\nSee [composer documentation](https://getcomposer.org/doc/06-config.md#platform)\non how to edit your `composer.json` to ensure that the correct dependencies are retrieved to match your deployment\nenvironment.\n\nSee [CLI vs Application run-time](https://php.watch/articles/composer-platform-check) for more details.\n\n### Additional Installation Options\n\nIf you want to write to PDF, or to include Charts when you write to HTML or PDF, then you will need to install additional libraries:\n\n#### PDF\n\nFor PDF Generation, you can install any of the following, and then configure PhpSpreadsheet to indicate which library you are going to use:\n- mpdf/mpdf\n- dompdf/dompdf\n- tecnickcom/tcpdf\n\nand configure PhpSpreadsheet using:\n\n```php\n// Dompdf, Mpdf or Tcpdf (as appropriate)\n$className = \\PhpOffice\\PhpSpreadsheet\\Writer\\Pdf\\Dompdf::class;\nIOFactory::registerWriter('Pdf', $className);\n```\nor the appropriate PDF Writer wrapper for the library that you have chosen to install.\n\n#### Chart Export\n\nFor Chart export, we support following packages, which you will also need to install yourself using `composer require`\n- [jpgraph/jpgraph](https://packagist.org/packages/jpgraph/jpgraph) (this package was abandoned at version 4.0.\n You can manually download the latest version that supports PHP 8 and above from [jpgraph.net](https://jpgraph.net/))\n- [mitoteam/jpgraph](https://packagist.org/packages/mitoteam/jpgraph) - up to date fork with modern PHP versions support and some bugs fixed.\n\nand then configure PhpSpreadsheet using:\n```php\n// to use jpgraph/jpgraph\nSettings::setChartRenderer(\\PhpOffice\\PhpSpreadsheet\\Chart\\Renderer\\JpGraph::class);\n//or\n// to use mitoteam/jpgraph\nSettings::setChartRenderer(\\PhpOffice\\PhpSpreadsheet\\Chart\\Renderer\\MtJpGraphRenderer::class);\n```\n\nOne or the other of these libraries is necessary if you want to generate HTML or PDF files that include charts; or to render a Chart to an Image format from within your code.\nThey are not necessary to define charts for writing to `Xlsx` files.\nOther file formats don't support writing Charts.\n\n## Hello World\n\nThis would be the simplest way to write a spreadsheet:\n\n```php\ngetActiveSheet();\n$activeWorksheet->setCellValue('A1', 'Hello World !');\n\n$writer = new Xlsx($spreadsheet);\n$writer->save('hello world.xlsx');\n```\n\n## Learn by example\n\nA good way to get started is to run some of the samples. Don't forget to download them via `--prefer-source` composer\nflag. And then serve them via PHP built-in webserver:\n\n```sh\nphp -S localhost:8000 -t vendor/phpoffice/phpspreadsheet/samples\n```\n\nThen point your browser to:\n\n> http://localhost:8000/\n\nThe samples may also be run directly from the command line, for example:\n\n```sh\nphp vendor/phpoffice/phpspreadsheet/samples/Basic/01_Simple.php\n```\n\n## Learn by documentation\n\nFor more documentation in depth, you may read about an [overview of the\narchitecture](./topics/architecture.md),\n[creating a spreadsheet](./topics/creating-spreadsheet.md),\n[worksheets](./topics/worksheets.md),\n[accessing cells](./topics/accessing-cells.md) and\n[reading and writing to files](./topics/reading-and-writing-to-file.md).\n\nOr browse the [API documentation](https://phpoffice.github.io/PhpSpreadsheet).\n\n# Credits\n\nPlease refer to the [contributor\nlist](https://github.com/PHPOffice/PhpSpreadsheet/graphs/contributors)\nfor up-to-date credits.\n" }, { "path": "docs/references/features-cross-reference.md", "content": "# Features cross reference\n\n- ✔ Supported\n- ● Partially supported\n- ✖ Not supported\n- N/A Cannot be supported\n\n## Readers\n\n
| \n | Readers | \n||||||||
|---|---|---|---|---|---|---|---|---|---|
| \n | XLS | \nXLSX | \nExcel2003XML | \nOds | \nGnumeric | \nCSV | \nSYLK | \nHTML | \n|
| Reader Options | \n✔ | \n✔ | \n● | \n● | \n✔ | \nN/A | \nN/A | \n✔ | \n|
| Read Charts | \n✖ | \n✔ | \n✖ | \n✖ | \n✖ | \nN/A | \nN/A | \n✖ | \n|
| Read Data Only (no formatting) | \n✔ | \n✔ | \n✖ | \n✔ | \n✔ | \nN/A | \nN/A | \n✔ | \n|
| Read Only Specified Worksheets | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \n✔ | \n|
| Read Only Specified Cells | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n✖ | \n✔ | \n|
| Read External Images | \n✖ | \n✔ 9 | \n✖ | \n✖ | \n✖ | \nN/A | \nN/A | \n✔ 9 | \n|
| Document Properties | \n● | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \n✔ | \n|
| Standard Properties | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \n✔ | \n|
| Creator | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \n✔ | \n|
| Creation Date/Time | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \n✔ | \n|
| Modifier | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \nN/A | \nN/A | \n✔ | \n|
| Modified Date/Time | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \nN/A | \n✔ | \n|
| Title | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \n✔ | \n|
| Description | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \n✔ | \n|
| Subject | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \n✔ | \n|
| Keywords | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \n✔ | \n|
| Extended Properties | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \nN/A | \nN/A | \n✔ | \n|
| Category | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \nN/A | \nN/A | \n✔ | \n|
| Company | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \nN/A | \nN/A | \n✔ | \n|
| Manager | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \nN/A | \nN/A | \n✔ | \n|
| User-Defined (Custom) Properties | \n✖ | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \nN/A | \n✔ | \n|
| Text Properties | \n✖ | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \nN/A | \n✔ | \n|
| Number Properties | \n✖ | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \nN/A | \n✔ | \n|
| Date Properties | \n✖ | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \nN/A | \n✔ | \n|
| Yes/No (Boolean) Properties | \n✖ | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \nN/A | \n✔ | \n|
| Cell Data Types | \n\n | \n | \n | \n | \n | \n | \n | \n | |
| Empty/NULL | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n|
| Boolean | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n|
| Integer | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n|
| Floating Point | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n|
| String | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n|
| Error | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n|
| Formula | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n✖ | \n✔ | \n✖ | \n|
| Array Formula | \n✖ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \n✖ | \nN/A | \n|
| Rich Text | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n✖ | \n✖ | \n✖ | \n\n |
| Conditional Formatting | \n✔ | \n✔ | \n✖ | \n✖ | \n✖ | \nN/A | \nN/A | \n✖ | \n|
| Rows and Column Properties | \n✔ | \n✔ | \n✔ | \n✖ | \n✔ | \nN/A | \nN/A | \n✔ | \n|
| Row Height/Column Width | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \n✔ | \n|
| Hidden | \n✔ | \n✔ | \n✔ | \n✖ | \n✔ | \nN/A | \nN/A | \n✔ | \n|
| Worksheet Properties | \n● | \n✔ | \n● | \n● | \n✖ | \nN/A | \nN/A | \n● | \n|
| Frozen Panes | \n✔ | \n✔ | \n✔ | \n✖ | \n✖ | \nN/A | \nN/A | \nN/A | \n|
| Hidden Worksheets | \n✔ | \n✔ | \n✖ | \n✔ | \n✖ | \nN/A | \nN/A | \n● | \n|
| Coloured Tabs | \n✖ | \n✔ | \n✖ | \n✖ | \n✖ | \nN/A | \nN/A | \nN/A | \n|
| Drawing hyperlink | \n✖ | \n✔ | \n✖ | \n✖ | \n✖ | \nN/A | \nN/A | \n✔ | \n|
| Cell Formatting | \n✔ | \n✔ | \n● | \n✖ | \n✔ | \nN/A | \n● | \n● 7 | \n|
| Number Format Mask | \n✔ | \n✔ | \n✔ | \n● 6 | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Alignment | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \n✖ | \n● 7 | \n|
| Horizontal | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \n✖ | \n✔ | \n|
| Vertical | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \n✖ | \n✔ | \n|
| Wrapping | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \n✖ | \n● | \n|
| Shrink-to-Fit | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \n✖ | \n● | \n|
| Indent | \n✔ | \n✔ | \n✖ | \n✔ | \n✔ | \nN/A | \n✖ | \n✔ | \n|
| Background Colour | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n● 7 | \n|
| Patterned | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \nN/A | \n✔ | \n✖ | \n|
| Font Attributes | \n✔ | \n✔ | \n✔ | \n● | \n✔ | \nN/A | \n✔ | \n● 7 | \n|
| Font Face | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Font Size | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Bold | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Italic | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Strikethrough | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Underline | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Superscript | \n✔ | \n✔ | \n✔ | \n✖ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Subscript | \n✔ | \n✔ | \n✔ | \n✖ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Borders | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \n● | \n● 7 | \n|
| Line Style | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Position | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Diagonal | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \n✖ | \n✖ | \n|
| Hyperlinks | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n✖ | \n✖ | \n✔ | \n|
| http | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \n✖ | \n✔ | \n|
| Merged Cells | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \n✖ | \n✔ | \n|
| Cell Comments | \n● | \n● | \n● | \n● | \n● | \nN/A | \n● | \n● | \n|
| Rich Text | \n✖ 2 | \n✔ | \n✖ | \n✖ | \n● | \nN/A | \nN/A | \n✖ | \n|
| Alignment | \n✖ 3 | \n✔ | \n✖ | \n✖ | \n✖ | \nN/A | \n✖ | \n✔ | \n|
| Background Image | \n✖ | \n✔ | \n✖ | \n✖ | \n✖ | \nN/A | \n✖ | \n✖ | \n|
| Cell Validation | \n✔ | \n✔ | \n✖ | \n✖ | \n✖ | \nN/A | \nN/A | \nN/A | \n|
| AutoFilters | \n● | \n● | \n● | \n● | \n● | \nN/A | \nN/A | \nN/A | \n|
| AutoFilter Expressions | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \nN/A | \n|
| Filter | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \nN/A | \n|
| Custom Filter | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \nN/A | \n|
| Date Filter | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \nN/A | \n|
| Dynamic Filter | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \nN/A | \n|
| Colour Filter | \n✖ | \n✖ | \n✖ | \n✖ | \n✖ | \nN/A | \nN/A | \nN/A | \n|
| Icon Filter | \n✖ | \n✖ | \n✖ | \n✖ | \n✖ | \nN/A | \nN/A | \nN/A | \n|
| Top 10 Filter | \n✖ | \n✔ | \n✖ | \n✖ | \n✖ | \nN/A | \nN/A | \nN/A | \n|
| Macros | \n✖ | \n● 5\n | ✖ | \n ✖ | \n ✖ | \n ✖ | \n ✖ | \n ✖ | \n | |
| Form Controls | \n✖ | \n● 4\n | ✖ | \n ✖ | \n ✖ | \n ✖ | \n ✖ | \n ✖ | \n | |
| Security | \n● | \n● | \n✖ | \n✖ | \n✖ | \n✖ | \n✖ | \n✖ | \n|
| Protection (prevent editing) | \n✔ | \n✔ | \n✖ | \n✖ | \n✖ | \n✖ | \n✖ | \n✖ | \n|
| Encryption (prevent viewing) | \n✖ | \n✖ | \n✖ | \n✖ | \n✖ | \n✖ | \n✖ | \n✖ | \n|
| \n | XLS | \nXLSX | \nExcel2003XML | \nOds | \nGnumeric | \nCSV | \nSYLK | \nHTML | \n|
| \n | Readers | \n
| \n | Writers | \n||||||
|---|---|---|---|---|---|---|---|
| \n | XLS | \nXLSX | \nOds | \nCSV | \nHTML | \n||
| Document Properties | \n\n | \n | \n | \n | \n | \n | |
| Standard Properties | \n\n | \n | \n | \n | \n | \n | |
| Creator | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Creation Date/Time | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✖ | \n|
| Modifier | \n✔ | \n✔ | \n✖ | \nN/A | \n✔ | \n✖ | \n|
| Modified Date/Time | \n✔ | \n✔ | \n✖ | \nN/A | \n✔ | \n✖ | \n|
| Title | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Description | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✖ | \n|
| Subject | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Keywords | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Extended Properties | \n\n | \n | \n | \n | \n | \n | |
| Category | \n✔ | \n✔ | \n✖ | \nN/A | \n✔ | \n✖ | \n|
| Company | \n✖ | \n✔ | \n✖ | \nN/A | \n✔ | \n✖ | \n|
| Manager | \n✖ | \n✔ | \n✖ | \nN/A | \n✔ | \n✖ | \n|
| User-Defined (Custom) Properties | \n✖ | \n✔ | \n✔ | \nN/A | \n✔ | \nN/A | \n|
| Rich Text | \n✔ | \n✔ | \n✖ | \nN/A | \n✔ | \n✔ | \n|
| Conditional Formatting | \n✔ | \n✔ | \n✖ | \n✖ | \n✖ | \n✖ | \n|
| Array Formula8 | \n✖ | \n✔ | \n✔ | \n✔ | \n✔ | \n✔ | \n|
| Rows and Column Properties | \n\n | \n | \n | \n | \n | \n | |
| Row Height/Column Width | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Hidden | \n✔ | \n✔ | \n✖ | \nN/A | \n✔ | \n✔ | \n|
| Worksheet Properties | \n\n | \n | \n | \n | \n | \n | |
| Frozen Panes | \n● | \n✔ | \n✖ | \nN/A | \n✔ | \n✖ | \n|
| Hidden Worksheets | \n● | \n✔ | \n✖ | \nN/A | \n✔ | \n✖ | \n|
| Coloured Tabs | \n✖ | \n✔ | \n✖ | \nN/A | \n✖ | \n✖ | \n|
| Drawing hyperlink | \n✖ | \n✔ | \n✖ | \nN/A | \n✖ | \n✖ | \n|
| Cell Formatting | \n\n | \n | \n | \n | \n | \n | |
| Number Format Mask | \n✔ | \n✔ | \n✔6 | \nN/A | \n✔ | \n✔ | \n|
| Alignment | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Horizontal | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Vertical | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Wrapping | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Shrink-to-Fit | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Indent | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Background Colour | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Patterned | \n✔ | \n✔ | \nN/A | \nN/A | \n✖ | \n✖ | \n|
| Font Attributes | \n\n | \n | \n | \n | \n | \n | |
| Font Face | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Font Size | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Bold | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Italic | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Strikethrough | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Underline | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Superscript | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Subscript | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Borders | \n\n | \n | \n | \n | \n | \n | |
| Line Style | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Position | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Diagonal | \n✔ | \n✔ | \n✔ | \nN/A | \n✖ | \n✖ | \n|
| Hyperlinks | \n✔ | \n✔ | \n✖ | \nN/A | \n✔ | \n✖ | \n|
| http | \n✔ | \n✔ | \n✖ | \nN/A | \n✔ | \n✖ | \n|
| Merged Cells | \n✔ | \n✔ | \n✔ | \nN/A | \n✔ | \n✔ | \n|
| Cell Comments | \n✖ | \n● | \n● | \nN/A | \n● 1 | \nN/A | \n|
| Rich Text | \n✖ | \n✔ | \n✖ | \nN/A | \n✖ | \nN/A | \n|
| Alignment | \n✖ | \n✔ | \n✖ | \nN/A | \n✔ | \nN/A | \n|
| Background Image | \n✖ | \n✔ | \n✖ | \n✖ | \n✖ | \n✖ | \n|
| Cell Validation | \n✔ | \n✔ | \n✖ | \nN/A | \nN/A | \nN/A | \n|
| AutoFilters | \n\n | \n | \n | \n | \n | \n | |
| AutoFilter Expressions | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \nN/A | \n|
| Filter | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \nN/A | \n|
| Custom Filter | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \nN/A | \n|
| DateGroup Filter | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \nN/A | \n|
| Dynamic Filter | \n✔ | \n✔ | \n✔ | \nN/A | \nN/A | \nN/A | \n|
| Colour Filter | \n✖ | \n✖ | \n✖ | \nN/A | \nN/A | \nN/A | \n|
| Icon Filter | \n✖ | \n✖ | \n✖ | \nN/A | \nN/A | \nN/A | \n|
| Top 10 Filter | \n✖ | \n✔ | \n✖ | \nN/A | \nN/A | \nN/A | \n|
| Macros | \n✖ | \n● 5\n | ✖ | \n N/A | \n ✖ | \n ✖ | \n | |
| Form Controls | \n✖ | \n● 4\n | ✖ | \n N/A | \n ✖ | \n ✖ | \n | |
| Security | \n\n | \n | \n | \n | \n | \n | \n |
| Protection (prevent editing) | \n✔ | \n✔ | \n✖ | \nN/A | \n✖ | \n✖ | \n|
| Encryption (prevent viewing) | \n✖ | \n✖ | \n✖ | \nN/A | \n✖ | \n✖ | \n|
| \n | XLS | \nXLSX | \nOds | \nCSV | \nHTML | \n||
| \n | Writers | \n
| \n | Methods | \n|
|---|---|---|
| \n | Getters | \nSetters | \n
| Reader Options | \n\n | \n |
| Read Data Only (no formatting) | \n$reader->getReadDataOnly() | \n$reader->setReadDataOnly() | \n
| Read Only Specified Worksheets | \n$reader->getLoadSheetsOnly() | \n$reader->setLoadSheetsOnly() $reader->setLoadAllSheets() | \n
| Read Only Specified Cells | \n$reader->getReadFilter() | \n$reader->setReadFilter() | \n
| Document Properties | \n\n | \n |
| Standard Properties | \n\n | \n |
| Creator | \n$spreadsheet->getProperties()->getCreator() | \n$spreadsheet->getProperties()->setCreator() | \n
| Creation Date/Time | \n$spreadsheet->getProperties()->getCreated() | \n$spreadsheet->getProperties()->setCreated() | \n
| Modifier | \n$spreadsheet->getProperties()->getLastModifiedBy() | \n$spreadsheet->getProperties()->setLastModifiedBy() | \n
| Modified Date/Time | \n$spreadsheet->getProperties()->getModified() | \n$spreadsheet->getProperties()->setModified() | \n
| Title | \n$spreadsheet->getProperties()->getTitle() | \n$spreadsheet->getProperties()->setTitle() | \n
| Description | \n$spreadsheet->getProperties()->getDescription() | \n$spreadsheet->getProperties()->setDescription() | \n
| Subject | \n$spreadsheet->getProperties()->getSubject() | \n$spreadsheet->getProperties()->setSubject() | \n
| Keywords | \n$spreadsheet->getProperties()->getKeywords() | \n$spreadsheet->getProperties()->setKeywords() | \n
| Extended Properties | \n\n | \n |
| Category | \n$spreadsheet->getProperties()->getCategory() | \n$spreadsheet->getProperties()->setCategory() | \n
| Company | \n$spreadsheet->getProperties()->getCompany() | \n$spreadsheet->getProperties()->setCompany() | \n
| Manager | \n$spreadsheet->getProperties()->getManager() | \n$spreadsheet->getProperties()->setManager() | \n
| User-Defined (Custom) Properties | \n$spreadsheet->getProperties()->getCustomProperties() $spreadsheet->getProperties()->isCustomPropertySet() $spreadsheet->getProperties()->getCustomPropertyValue() $spreadsheet->getProperties()->getCustomPropertyType() | \n $spreadsheet->getProperties()->setCustomProperty() | \n
| Drawing hyperlink | \n$drawing->getHyperlink()->getUrl() | \n$drawing->setHyperlink()->setUrl($url) | \n
| Hyperlinks | \n$cell->getHyperlink()->getUrl($url) | \n$cell->getHyperlink()->setUrl($url) | \n
| Cell Comments | \n\n | \n |
| Background Image | \n$comment->getBackgroundImage() | \n$comment->setBackgroundImage() | \n
| Cell Validation | \n$cell->getDataValidation() | \n$cell->setDataValidation() | \n
| AutoFilters | \n$sheet->getAutoFilter() | \n$sheet->setAutoFilter() | \n
| Macros | \n$spreadsheet->getMacrosCode();5 | \n$spreadsheet->setMacrosCode();5 | \n
| Security | \n\n | \n |
| Protection (prevent editing) | \n$sheet->getProtection() | \n$sheet->getProtection()->setSheet(true) | \n
| \n | Getters | \nSetters | \n
| \n | Methods | \n
(if omitted, 24-hour time format is used) | AM or PM |\n\nExcel also supports Masks for Time Durations (note that spreadsheets using the 1904 base date can display negative durations, but those using the 1900 base date cannot). There is no \"Wizard\" for this; but the following Mask codes can be used to display Durations.\n\n| Code | Description | Displays as |\n|---------|----------------------------------------------------------------|-------------|\n| [h]:mm | Elapsed time in hours | e.g. 25:02 |\n| [hh]:mm | Elapsed time in hours
with a leading zero if less than 10 | e.g. 05:02 |\n| [mm]:ss | Elapsed time in minutes | e.g. 63:46 |\n| [m]:ss | Elapsed time in minutes
with a leading zero if less than 10 | e.g. 03:46 |\n| [s] | Elapsed time in seconds | |\n| [ss] | Elapsed time in seconds
with a leading zero if less than 10 | |\n\n### Percentage\n\nThis is among the simplest of the Excel \"Wizards\", only allowing you to specify the number of decimals to be displayed.\n\n\n\nThe Percentage mask looks like '0.00%'.\n\nUsing the `%` code in a mask will multiply the value by 100 before rendering it, and it will always also display the `%` sign.\n\nThe PhpSpreadsheet \"Wizard\" replicates this simple option; but also provides a locale option that allows locale-specific formatting, because there are a few locales where the percentage sign appears before the value rather than after it.\nAs with all locale use for the PhpSpreadsheet \"Wizard\", this is dependent on having the `Intl` extension enabled.\n\n```php\nuse PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Percentage;\n\n// Set Cell value\n$worksheet->getCell('C21')->setValue(-12345.67890);\n\n// Set Cell Style using the Percentage Wizard to build the Format Mask for a locale\n$localeCurrencyMask = new Percentage(\n locale: 'tr_TR'\n);\n$worksheet->getCell('C21')\n ->getStyle()->getNumberFormat()\n ->setFormatCode($localeCurrencyMask);\n\nvar_dump($worksheet->getCell('C21')\n ->getStyle()->getNumberFormat()->getFormatCode()); // %#,##0.00\nvar_dump($worksheet->getCell('C21')->getFormattedValue()); // %-12,345.68\n```\n\n### Fraction\n\nMS Excel presents two different options for fractions: the first where the denominator is calculated internally to either 1, 2 or 3 digits; and the second (introduced only recently) where the denominator is fixed as 2, 4, 8 or 16.\n\n\n\nThe Fraction mask looks like '# ?/???' where `#` indicates that the integer part of the value should be displayed, and then `?/???` to display the fraction with up to 3 digits in the denominator.\nThe mask using a fixed-denominator looks like '# ?/16', with the denominator value replacing the variable `?`.\n\nIf you use digit placeholders (`/??`) for the denominator, then Excel will calculate the lowest denominator that it can use for the fractional value. If you specify a fixed denominator (e.g. `/8`) then Excel will calculate the fraction in eighths.\n\n> **Note:** The internal renderer in PhpSpreadsheet does not consider the number of digits for the denominator, but will simply try to identify the lowest value denominator that it can use.\n\nThere is currently no PhpSpreadsheet \"Wizard\" for Fraction Masks.\n\n### Scientific\n\nThis is among the simplest of the Excel \"Wizards\", only allowing you to specify the number of decimals to be displayed.\n\n\n\nThe Scientific mask looks like '0.00E+00'.\n\n> **Note**: The internal rendering used by PhpSpreadsheet will display only as many digits as necessary for the exponent; while the Excel mask specifies a minimum of 2 digits, with a leading zero if necessary.\n\nThe PhpSpreadsheet \"Wizard\" replicates this simple option.\n```php\nuse PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Scientific;\n\n// Set Cell value\n$worksheet->getCell('C20')->setValue(-12345.67890);\n\n// Set Cell Style using the Scientific Wizard to build the Format Mask\n$scientificMask = new Scientific(\n 4,\n);\n$worksheet->getCell('C20')\n ->getStyle()->getNumberFormat()\n ->setFormatCode($scientificMask);\n\nvar_dump($worksheet->getCell('C20')\n ->getStyle()->getNumberFormat()->getFormatCode()); // 0.0000E+00\nvar_dump($worksheet->getCell('C20')->getFormattedValue()); // -1.2346E+4\n\n// Set Cell value\n$worksheet->getCell('C21')->setValue(-12345.67890);\n\n// Set Cell Style using the Scientific Wizard to build the Format Mask for a locale\n$localeScientificMask = new Scientific(\n 3,\n locale: 'nl_NL'\n);\n$worksheet->getCell('C21')\n ->getStyle()->getNumberFormat()\n ->setFormatCode($localeScientificMask);\n\nvar_dump($worksheet->getCell('C21')\n ->getStyle()->getNumberFormat()->getFormatCode()); // 0.000E+00\nvar_dump($worksheet->getCell('C21')->getFormattedValue()); // -1.235E+4\n```\n\nIf you specify a number of decimals to display, then the Scientific \"Wizard\" will apply that value, even when using a locale.\n\n### Text\n\nMS Excel's Text \"Wizard\" has no options, but simply sets a mask to `@`, meaning display the value exactly as it is entered.\nUnlike `General`, which is adaptive, `@` will not change the displayed value in any way, except in one exceptional case (see note below).\nVery large or very small values will not be displayed in Scientific format, and leading zeroes will be displayed.\n\n>**Note:** If your cell contains Rich Text, then using `@` in a format mask will display it using the basic cell styling, ignoring the Rich Text styling.\n\n\n\nPhpSpreadsheet doesn't emulate this behaviour; it simply displays the value as PHP would render that value cast to a string, which mimics Excel's quirk with Rich Text values.\n\nThere is no PhpSpreadsheet \"Wizard\" for Text Masks.\n\n### Special\n\nExcel's Special format \"Wizard\" is a recent introduction: select a locale, and then you may be offered a number of options for formatting values in a manner that is appropriate to that locale, such as US phone numbers, social security numbers, or zip codes; typically with separators between groups of digits.\nAt this time, most locales have no special formats defined.\n\n\n\nThere is no PhpSpreadsheet \"Wizard\" for Special Masks.\n\n## Custom Format Masks\n\nThe Custom \"Wizard\" really isn't a Wizard at all, just an editing field that allows you to pre-populate from a list of common format masks before editing.\n\n\n\nIt does mean that you need to understand the rules for defining masks when you use this.\n\nWhen you create custom number formats, you can specify up to four sections of format code.\nThese sections of code must be separated by semicolons (`;`).\n\n### Sections for Composite Masks\n\nSections of the mask define the formats for positive numbers, negative numbers, zero values, and text, in that order.\n\n\n 1. Format for Positive values\n 2. Format for Negative values\n 3. Format for Zero values\n 4. Format for Text\n\nIf you specify only one section of format code, the code in that section is used for all numbers.\nIf you specify two sections of format code, the first section of code is used for positive numbers and zeros, and the second section of code is used for negative numbers.\nIf you specify a third section, then the first applies to positive values, the second to negative values, and the third to zero values.\nThe fourth section only applies if the value is not numeric.\n\nIf you skip code sections in the format mask, then you must include a semicolon for each of the missing sections.\n\nWhen you skip code sections in the format mask, then you must include a semicolon for each of the missing sections. Use `;` to indicate that a section exists, but with an empty mask; and that can be used to hide values that match the criteria for that section.\n\n\n\n> **Note:** Negative values aren't shown with a sign when we use the negative value section. If we want the value to display with a sign, then we need to include an explicit '-' character in the Mask for that section (\";-0;\").\n\n### Basic Masking Symbols\n\nThree basic masking symbols are used to display numbers, and they differ in the way that they display leading or trailing zeroes.\nThe fourth basic masking symbol is the text placeholder, which can be used to wrap the cell value within additional formatting.\n\n| Code | Description | Examples | \n|------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 0 | Digit placeholder that displays insignificant zeros. | #.00 - always displays 2 decimal places.
If you type 5.5 in a cell, it will display as 5.50. |\n| # | Digit placeholder that represents optional digits and does not display extra zeros.
That is, if a number doesn't need a certain digit, it won't be displayed. | #.## - displays up to 2 decimal places.
If you type 5.5 in a cell, it will display as 5.5.
If you type 5.555, it will display as 5.56. |\n| ? | Digit placeholder that leaves a space for insignificant zeros on either side of the decimal point but doesn't display them. It is often used to align numbers in a column by decimal point. | #.??? - displays a maximum of 3 decimal places and aligns numbers in a column by decimal point. |\n| @ | Text placeholder | 0.00; -0.00; 0; [Red]@ - applies the red font colour for text values. |\n\nIf a number entered in a cell has more digits to the right of the decimal point than there are placeholders in the format, the number is \"rounded\" to as many decimal places as there are placeholders.\nFor example, if you have a value of `2.25` in a cell with '#.#' format, then the number will be rounded to 1 decimal, and will display as `2.3`.\n\nDigits to the left of the decimal point are always displayed regardless of the number of placeholders.\nFor example, if the value in a cell is `202.25` with '#.#' format, the number will display as `202.3`.\n\n\n\nTo display leading zeroes for a numeric value, you might create a mask like '0000', which will always display at least 4 digits, padding the value with leading zeroes if it is less than 1000.\n\n### Other Special Codes\nIn addition to the masking symbols listed above, the following codes also enable special rendering of the value.\n\n| Code | Description | Example |\n|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------|\n| . (period) | Decimal point. | ##0.00?? |\n| , (comma) | Thousands Separator.
A comma that follows a digit placeholder scales the number by a thousand. | #,##0
0.000,
Described below. |\n| \\ | Text Escape Character that displays the character that follows it. | ##0\\°
Described below. |\n| \" \" | Display any text that is enclosed in the double quotes. | ##0\"°C\"
Described below. |\n| % | Multiplies the value stored in the cell by 100 and display it with the percentage sign. | Examples provided in the \"Wizard\" section above. |\n| / | Display the value as a fraction. | Examples provided in the \"Wizard\" section above. |\n| E | Display the value in Scientific Format. | Examples provided in the \"Wizard\" section above. |\n| _ (underscore) | Space pad to the width of the next character in the mask.
It is commonly used in combination with parentheses to add left and right indents, `_(` and `_)` respectively. | Described below. | \n| * (asterisk) | Repeats the character that follows it until the width of the cell is filled.
It is often used in combination with the space character to change alignment. | Described below. |\n\nSimple examples of using these codes for Percentages, Fractions and Scientific Format can be found in the descriptions of those \"Wizards\".\nThe other codes are described in detail below.\n\n### Thousands Separator and Scaling\n\nTo create an Excel custom number format with a thousands separator, include a comma (`,`) in the format code. For example:\n\n - #,### - display a thousands separator and no decimal places.\n - #,##0.00 - display a thousands separator and 2 decimal places.\n\nMicrosoft Excel separates thousands by commas: if a comma is enclosed by any digit placeholders - the pound sign (`#`), question mark (`?`) or zero (`0`).\nBut if no digit placeholder follows a comma, it scales the number by a thousand, two consecutive commas scale the number by a million, and so on.\n\nFor example, if a cell format is '#.00,' and the cell value is `5000`, then the number `5.00` is displayed.\n\n\n\n### Formatting with Text\n\nIf you want to include text in your format mask with numeric values, then there are two basic options.\nTo add a single character, then you can prefix that character with a backslash ('\\'), e.g. '#.00,\\K' or '#.00,,\\M'.\n\n\n\nYou don't need the backslash ('\\') prefix for the following list of characters:\n\n| Character | Description | \n|-----------|----------------------------------|\n| + and - | Plus and Minus Signs |\n| ( and ) | Left and Right Parenthesis |\n| : | Colon |\n| ^ | Caret |\n| ' | Apostrophe |\n| { and } | Curly Braces |\n| < and > | Less Than and Greater than Signs |\n| = | Equals Sign |\n| / | Forward Slash |\n| ! | Exclamation Mark |\n| & | Ampersand |\n| ~ | Tilde |\n| | Space Character |\n\nYou can also use additional padding characters if you want to break a number into groups. For example, to display a number as a phone number, you might use a mask like '00-0000-0000' or '(++00) 00-0000-0000'.\n\nIt's a common practise in Accounting formats to wrap negative values in brackets; so you might use '([$€-nl-NL] #,##0.00)' for that section of the mask.\n\nTo add words or for phrases to the mask, you should wrap the text in quotes: e.g. '#.00\" Surplus\";-#.00\" Deficit\";\"Out of Stock\"'.\n\n\n\n### Indents, Spacing and Alignment\n\nIf you're wrapping negative values in brackets, you might like like to align your positive values with your negative values on the decimal, then you need to apply indents to the positive values to match the width of the bracket characters.\nThe underscore code (`_`) tells Excel to pad the display to the width of the next character in the mask, so '_)' would tell Excel to pad to the width of ')' character like '[$€-nl-NL] _(#,##0.00_);[$€-nl-NL] (#,##0.00)'.\n\n\n\nAccountants might also appreciate if the Currency symbols were also all aligned; so we can use the `*` code followed by a repeated character; and that will pad the width of the cell with the specified character. Typically, although not always, this will be a space character, '* '.\n\n\n\nWhich aligns all our currency symbols to the left of the cell, while displaying the value right-aligned in the cell, and all the decimal points neatly aligned.\n\nThe `*` code can also be used to change the alignment of a value in a cell. If we want text to be rendered right aligned, even though the cell is left aligned, we can use '* @' as the mask, and this will push the display to the right of the cell.\n\n\n\nNote that padding is not supported by PhpSpreadsheet's internal renderer for the cell's `getFormattedValue()` method, because the renderer is unaware of font or cell width, so it will simply add a single space in the formatted result. Nor will it change alignment in any way.\n\n### Colours\n\nYou can use format masks to change the font colour for a certain value with a custom number format.\ne.g. '[Red]@'\n\nMasking supports the following 8 main colours.\n\n - Black\n - Red\n - Green\n - Blue\n - Cyan\n - Yellow\n - Magenta\n - White\n\nTo specify the colour, just type one of those colour names in the appropriate section of your number format code, wrapped in square braces (e.g. '[red]').\nThis colour code must be at the very start of the section, before any other formatting characters or instructions.\nThe colour name is case-insensitive.\n\nIf we wanted to show positive values in green and negative values in red we could apply different colours to the different sections of the mask, e.g. \"[Green]#,##0.00;[Red]#,##0.00;0.00\".\n\n> **Warning**: Colour masking doesn't apply when using Excel's `TEXT()` function; only when it is applied to a Cell's Format Mask.\n\n### Conditional Formatting\n\nNot to be confused with actual Conditional Formatting in MS Excel; but we can apply some limited condition checks in normal Cell Format Masks, and apply different masking based on those conditions.\n\nWhile by default the different sections are interpreted by Excel as positive, negative, zero and text, we can override these definitions with conditions.\nWe do this by defining the condition for matching against the value inside square braces.\n\n\n\nThe mask that we're using here is `[Red][<65]\"Fail\";[Blue]\"Pass\"`.\nThis tells Excel to display the text \"Fail\" if the value in the Cell is less than 65, otherwise to display \"Pass\".\n\nThe symbols allowed for comparison in Conditions are the standard mathematical comparison operators:\n\n| Symbol | Meaning | \n|--------|-----------------------|\n| \\> | Greater than |\n| \\>= | Greater than or Equal |\n| < | Less than |\n| <= | Less than or Equal |\n| = | Equal |\n| <\\> | Not Equal |\n\nIn this next example, we've created an additional condition, so we have three sections in the mask: the \"Pass\" grade is now any student that hasn't failed, but whose score is less than 85; the last section awards a grade of \"Distinction\" to any student whose score doesn't match the criteria for \"Pass\" or \"Fail\" (i.e. exceeds 85).\n`[Red][<65]\"Fail\";[Blue][<85]\"Pass\";\"Distinction\"`\n\n\n\nWe do need to be careful about the order that we define the conditions, because Excel will apply the mask for the first condition that matches the Cell value.\n\n> **Note**: Conditional Formatting using the Number Mask will also work with the TEXT() Function, although not with colour highlighting.\n\nWe can also use Conditional Formatting to display Lakh, the different grouping often found in India and the countries of that region.\nWhile the thousands separator normally represents grouping to powers of 3 (103, 106, 109, etc), the Lakh is 103, 105, 107, etc. and is written as `1,00,000`.\nAfter the first 1000, the comma separator is used to represent groups of 2 digits, not groups of 3 digits.\n150,000 rupees is 1.5 lakh rupees, and is written as `₹1,50,000` or `INR 1,50,000`.\n\nThe mask used to represent lakh is:\n[>=10000000][$₹]##\\,##\\,##\\,##0;[>=100000][$₹]##\\,##\\,##0;[$₹]##,##0\n\nNote that we're only using the `,` for thousands grouping in the final block, to represent values less than 100,000 where we would only display a single `,` as a thousands separator.\nFor the `,` in higher values, we are displaying a string literal `,` identified as such by the '\\' immediately before it in the mask.\n\n## Building Composite Masks using PhpSpreadsheet's Wizards\n\nEven though PhpSpreadsheet's Wizards don't yet support building sections with different masks for positive, negative, zero, and text, you can still create these using the Wizards as building blocks.\n\n```php\nuse PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Currency;\nuse PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Number;\n\n// Set Cell value\n$worksheet->getCell('C20')->setValue(-12345.67890);\n\n// Set Cell Style using the Currency Wizard to build the Format Mask\n$currencyMask = new Currency(\n '€',\n 2,\n Number::WITH_THOUSANDS_SEPARATOR,\n Currency::TRAILING_SYMBOL,\n Currency::SYMBOL_WITH_SPACING\n);\n\n// Build the composite mask applying colours to the different sections\n$compositeCurrencyMask = [\n '[Green]' . $currencyMask,\n '[Red]' . $currencyMask,\n $currencyMask,\n];\n\n$worksheet->getCell('C20')\n ->getStyle()->getNumberFormat()\n ->setFormatCode(implode(';', $compositeCurrencyMask));\n\nvar_dump($worksheet->getCell('C20')\n ->getStyle()->getNumberFormat()\n ->getFormatCode()); // [Green]#,##0.00 €;[Red]#,##0.00 €;#,##0.00 €\n```\nWe repeat the mask that's generated by the \"Wizard\" for each section of the composite mask, adding the required colour to each section.\n\nIf we've used a locale to build a mask, then we may already have multiple sections:\n```php\nuse PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Currency;\n\n// Set Cell value\n$worksheet->getCell('C20')->setValue(-12345.67890);\n\n// Set Cell Style using the Currency Wizard to build the Format Mask\n$currencyMask = new Currency(\n '€',\n locale: 'nl_NL'\n);\n\n// Split the generated mask into sections\n// This particular mask already has positive and negative value sections,\n// but does not have a zero value section\n// Other locales may only have a positive section; or may already have a zero section\n$currencyMaskSections = explode(';', $currencyMask);\n// Recreate the modified mask applying colours to the different sections\n$compositeCurrencyMask = [\n '[Green]' . $currencyMaskSections[0],\n '[Red]' . $currencyMaskSections[1] ?? $currencyMaskSections[0],\n $currencyMaskSections[2] ?? $currencyMaskSections[0],\n];\n\n$worksheet->getCell('C20')\n ->getStyle()->getNumberFormat()\n ->setFormatCode(implode(';', $compositeCurrencyMask));\n\nvar_dump($worksheet->getCell('C20')\n ->getStyle()->getNumberFormat()\n // [Green][$€-nl-NL] #,##0.00;[Red][$€-nl-NL] -#,##0.00;[$€-nl-NL] #,##0.00\n ->getFormatCode());\n```\nIf the locale-generated mask already has a section defined, then we use that, otherwise we use the positive section (section 0) that will always exist as the base for each section.\n> **Warning:** You might need to add an explicit `-` for the negative section if that needs to be created.\n\n## Summary\n\nEven though Excel displays the formatted value in the grid, the underlying value in the cell is unchanged.\nThe value being displayed as a date is still an Excel Serialized Timestamp, even though it is being displayed as '2023-02-28'; the student grade is still a number, even though it is being displayed as \"Distinction\"/\"Pass\"/\"Fail\"; and the cell that looks empty may not be as empty as you think.\nThe edit bar still shows us the value in the cell, not the formatted value; and we can still use that underlying value in formulae.\n\n\n\nAnd we can even format the cell containing the result of that formula.\n\nNumber format masks allow us to present the spreadsheet data in a format that makes it easy for the user to interpret; so they add a lot of value to the spreadsheets that we create.\nWe just need to understand how to use them well to unlock that value.\n" }, { "path": "docs/topics/Excel Anomalies.md", "content": "# Excel Anomalies\n\nThis is documentation for some behavior in Excel itself which we\njust do not understand, or which may come as a surprise to the user.\n\n## Date Number Format\n\nMy system short date format is set to `yyyy-mm-dd`. Excel, for a very long time, did not include that amongst its formatting choices for dates, so it needed to be added as a custom format - no big deal. It has recently been added to the list of date formats, but ...\n\nI used Excel to create a spreadsheet, and included some dates, specifying `yyyy-mm-dd` formatting. When I looked at the resulting spreadsheet, I was surprised to see that Excel had stored the style not as `yyyy-mm-dd`, but rather as builtin style 14 (system short date format). Apparently the fact that the Excel styling matched my system choice was sufficient for it to override my choice! This is an astonishingly user-hostile implementation. Even though there are formats which, by design, \"respond to changes in regional date and time settings\", and even though the format I selected was not among those, Excel decided it was appropriate to vary the display even when I said I wanted an unvarying format. I assume, but have not confirmed, that this applies to formats other than `yyyy-mm-dd`.\n\nNote that this is not a problem when using PhpSpreadsheet to set the style, only when you let Excel do it. And, in that case, after a little experimentation, I figured out a format that Excel doesn't sabotage `[Black]yyyy-mm-dd`.\n\nIf you have a spreadsheet that has been altered in this way, it can be fixed with the following PhpSpreadsheet code:\n```php\n foreach ($spreadsheet->getCellXfCollection() as $style) {\n $numberFormat = $style->getNumberFormat();\n // okay to use NumberFormat::SHORT_DATE_INDEX below\n if ($numberFormat->getBuiltInFormatCode() === 14) {\n $numberFormat->setFormatCode('yyyy-mm-dd');\n }\n }\n```\nStarting with PhpSpreadsheet 4.5.0, this can be simplified to:\n```php\n $spreadsheet->replaceBuiltinNumberFormat(\n \\PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat::SHORT_DATE_INDEX,\n 'yyyy-mm-dd'\n );\n```\n\n## Negative Time Intervals\n\nYou have a time in one cell, and a time in another, and you want to subtract and display the result in `h:mm` format. No problem if the result is positive. But, if it's negative, Excel just fills the cell with `#`. There is a solution of sorts. If you use a 1904 base date (default on Mac), the negative interval will work just fine. Alas, no dice if you use a 1900 base data (default on Windows). No idea why they can't fix that - the existing implementation can't really be something that anybody actually wants. Note that it is *not* safe to change the base date for an existing spreadsheet, so, if this is something you want to do, make sure you change the base date before populating any data.\n\n## Long-ago Dates\n\nExcel does not support dates before either 1900-01-01 (Windows default) or 1904-01-01 (Mac default). For the 1900 base year, there is the additional problem that non-existent date 1900-02-29 is squeezed between 1900-02-28 and 1900-03-01.\n\n## Weird Fractions\n\nSimilar fraction formats have inconsistent results in Excel. For example, if a cell contains the value 1 and the cell's format is `0 0/0`, it will display as `1 0/1`. But, if the cell's format is `? ??/???`, it will display as `1`. See [this issue](https://github.com/PHPOffice/PhpSpreadsheet/issues/3625), which remains open because, in the absence of usable documentation, we aren't sure how to handle things.\n\n## COUNTIF and Text Cells\n\nIn Excel, COUNTIF appears to ignore text cells, behavior which doesn't seem to be documented anywhere. See [this issue](https://github.com/PHPOffice/PhpSpreadsheet/issues/3802), which remains open because, in the absence of usable documentation, we aren't sure how to handle things.\n\n## SORT on Different DataTypes\n\nExcel appears to sort so that numbers are lowest in sort order, strings are next, booleans are next (LibreOffice treats booleans as ints), and null is highest. In addition, if your sort includes a numeric string with a leading plus or minus sign, the plus sign will be considered part of the string (so that `\"+1\"` will sort before `\"0\"`), but the minus sign will be ignored (so that `\"-3\"` will sort between `\"25\"` and `\"40\"`). There might be nuances I haven't thought of yet. PhpSpreadsheet will not necessarily duplicate Excel's behavior. The best advice we can offer is to make sure that arrays you wish to sort consist of a single datatype, and don't contain numeric strings. Samples samples/LookupRef/SortExcel and SortExcelCols are added to give an idea of how you might emulate Excel's behavior. I am not yet convinced that there is a use case for adding it as a class member in the src tree.\n" }, { "path": "docs/topics/Looping the Loop.md", "content": "# Looping the Loop\n\nPhpSpreadsheet uses a lot of memory to maintain the Spreadsheet model; but I regularly see developers loading a Spreadsheet file and then calling the `toArray()` methods so that they can loop through the rows and columns of a worksheet.\nPHP arrays are also notoriously memory-intensive, so creating a large array duplicating the data that is already in the Spreadsheet model is a very inefficient use of memory.\nGenerally, unless we are always working with very small spreadsheets, we would want to avoid this.\n\nSo in this article, I'm going to look at a number of different ways of iterating through a worksheet to access the row and cell data; at their limitations; and at some of the options that each provides.\n\n## Using `toArray()`\n\nUsing a sample data file from Microsoft and available at https://go.microsoft.com/fwlink/?LinkID=521962, I can load up the file, call `toArray()` to return the worksheet data in an array, and iterate over the rows and cells of that array with the following code.\n\n```php\n$inputFileType = 'Xlsx';\n$inputFileName = __DIR__ . '/../Financial Sample.xlsx';\n\n$reader = IOFactory::createReader($inputFileType);\n$spreadsheet = $reader->load($inputFileName);\n$worksheet = $spreadsheet->getActiveSheet();\n\n$dataArray = $worksheet->toArray();\n\nforeach ($dataArray as $row) {\n foreach ($row as $cellValue) {\n // Do something with the cell data here.\n }\n}\n```\n\nThe Financial Sample spreadsheet is fairly small, 701 rows (including a heading row) and 16 columns; and is predominantly numeric data.\nTo simulate a larger worksheet, I've duplicated that data to give 7001 rows; but this is still a small worksheet as MS Excel xlsx files can contain 1 million rows in each of several worksheets.\n\nIf we look at the timings and memory usage for this process with my extended MS Financial Sample spreadsheet:\n```\nCurrent memory usage: 47104 KB\n\nCall time to build array was 0.6603 seconds\n\nCall time to iterate array rows was 0.0130 seconds\nCurrent memory usage: 57344 KB\n Peak memory usage: 57344 KB\n```\nWe can see that using `toArray()` increases memory usage by 10240KB (10MB): that is the memory used by the array for a relatively small worksheet (less than 120,000 cells).\nFor larger worksheets, with more rows and columns, and with more text than numeric values, this memory overhead can grow significantly larger.\n\nAnd while iteration over the array is very quick, it still takes 0.6603 seconds to build the array before we can start iterating over those rows and cells.\n\n---\n\nThe `toArray()` method is easy to use: but not only is it increasing the memory overhead, especially with larger worksheets; but it also lacks flexibility.\nIt provides limited control over how the data from each cell is returned in the array.\nIt can return the raw cell value (which isn't particularly useful if the cell contains a formula, or if the value should be interpreted as a date); it can force PhpSpreadsheet to calculate formulae and return the calculated value; or it can return the formatted cell value (which includes calculating any formulae) so that date values are presented in a human-readable format, but which will also format numeric values with thousand separators where the cell style applies that.\n\n| Argument Name | DataType | Default | Purpose |\n|--------------------|----------|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| $nullValue | mixed | null | A value to be returned in the array if a cell doesn't exist. |\n| $calculateFormulas | boolean | false | Flag to indicate if formula values should be calculated before returning. |\n| $formatData | boolean | false | Flag to request that values should be formatting before returning. |\n| $returnCellRef | boolean | false | False - Return a simple enumerated array of rows and columns (indexed by number counting from zero)
True - Return rows and columns indexed by their actual row and column IDs. |\n| $ignoreHidden | boolean | false | True - Ignore hidden rows and columns. |\n| $reduceArrays | boolean | false | True - If calculated value is an array, reduce it to top leftmost value. |\n| $lessFloatPrecision | boolean | false | True - PhpSpreadsheet 5.2+ - Floats, if formatted, will display as a more human-friendly but possibly less accurate value. |\n\n### Dealing with empty rows\n\nThe example spreadsheet that I've used here is well behaved, with no empty rows. Empty rows can cause problems, even when working in Excel itself.\n\nLet's take a look at a worksheet of Sales Data, where we're missing the returns for a couple of months:\n\n\n\nIf we're using MS Excel, and we hit `Ctrl-T` to create a table from this data, we might expect Excel to build that table from all rows up to `Dec`; but it won't, it will only build the table up to the next empty row.\n\n\n\nAnd unless we're careful, we might not even notice that the last few months of the year are omitted.\nSo empty rows can create problems even in MS Excel itself; and we certainly need to have some way of identifying them when we're processing a worksheet using PhpSpreadsheet.\n\n---\n\nWhile we're iterating through a spreadsheet with PhpSpreadsheet, we might want to avoid trying to process blank data if we reach a row that is empty; or we might want to terminate iterating when we encounter an empty row.\n\nIf we've created an array from a worksheet, then an empty row will be a row where every cell/column entry has a null value (unless called specifying an alternative value using the `$nullValue` argument).\n\nWe can filter the row to eliminate null values, then count the length of that filtered array: if there are no remaining cells, then the row is empty. We can then skip that row in our code using `continue`.\n\n```php\nforeach ($dataArray as $row) {\n // Check for empty rows\n if (count(array_filter($row, function ($value) {\n return $value !== null;\n })) === 0) {\n continue; // Ignore empty rows\n }\n\n foreach ($row as $cellValue) {\n // Do something with the cell data here.\n }\n}\n```\n\nOr if we want to terminate iterating when we encounter an empty row, use `break` rather than `continue`.\n\n```php\nforeach ($dataArray as $row) {\n // Check for empty rows\n if (count(array_filter($row, function ($value) {\n return $value !== null;\n })) === 0) {\n break; // Stop at the first empty row\n }\n\n foreach ($row as $cellValue) {\n // Do something with the cell data here.\n }\n}\n```\n\nUsing `toArray()` won't change anything in the worksheet model: it won't modify values or create new cells.\nIt will return a row/column entry for every cell that can exist, even if that cell doesn't exist in the worksheet, or is part of a merge range.\n> **Note**: It is possible for several cells in a merge range to have a value. Although MS Excel doesn't allow you to set data like this, the option is available in other Spreadsheet software, and if the file is saved as an xlsx file, then the data for those cells is retained in the file, even though only the top left cell of a merge range shows a value in MS Excel. In PhpSpreadsheet, accessing those cells (including using `toArray()`) will return the \"hidden\" value.\n\nOne useful factor about returning an array of arrays is if we want to populate a data model from that row before persisting to a database, for example. We don't need to iterate the columns in that row, but can work directly with the column array for each row.\n\n```php\nclass MonthlySales {\n private function __construct(\n public readonly string $month,\n public readonly array $sales,\n ) {}\n\n public static function fromExcel(array $values, array $headers): self {\n $month = array_shift($values);\n return new self($month, array_combine($headers, $values));\n }\n}\n\n$monthlySalesData = new MonthlySalesCollection();\n\n// Read from the header row of the worksheet\n$excelHeaderRow = ['Jones', 'Sorvino', 'Gupta', 'Choi'];\n\n$dataArray = $worksheet->toArray(formatData: true);\nforeach ($dataArray as $excelDataRow) {\n // Check for empty rows\n if (count(array_filter($excelDataRow, function ($value) {\n return $value !== null;\n })) === 0) {\n continue; // Ignore empty rows\n }\n\n $monthlySalesData->add(MonthlySales::fromExcel(\n $excelDataRow,\n $excelHeaderRow\n ));\n}\n```\nWe can pass the row array directly to the static `MonthlySales::fromExcel()` constructor for our data object, handling any validation and manipulation of the structure there, to map the Excel data row to that object properties, handling filtering within the business logic of the Monthly Sales object's static constructor.\n\n---\n\nAnd remember that by default, `toArray()` returns a simple enumerated array of enumerated arrays, to reflect rows and columns. You can modify this using the `$returnCellRef` argument to the method: set `$returnCellRef` to true, and the array indexes will be the row number (with 1 as the first row) and the column address ('A', 'B', 'C', etc); which can be useful if you want to do some processing of the cells based on that column address.\n\n```php\nclass MonthlySales {\n private function __construct(\n public readonly string $month,\n public readonly array $sales,\n ) {}\n\n public static function fromExcel(array $values, array $headers): self {\n $month = array_shift($values);\n $salesValues = [];\n foreach ($values as $column => $value) {\n // Ignore salespeople who have null sales values\n if ($value !== null) {\n $salesValues[$headers[$column]] = $value;\n }\n }\n return new self($month, $salesValues);\n }\n}\n\n$monthlySalesData = new MonthlySalesCollection();\n\n// Read from the header row of the worksheet\n$excelHeaderRow = [\n 'B' => 'Jones',\n 'C' => 'Sorvino',\n 'D' => 'Gupta',\n 'E' => 'Choi'\n];\n\n$dataArray = $worksheet->toArray(formatData: true, returnCellRef: true);\nforeach ($dataArray as $excelDataRow) {\n // Check for empty rows\n if (count(array_filter($excelDataRow, function ($value) {\n return $value !== null;\n })) === 0) {\n continue; // Ignore empty rows\n }\n\n $monthlySalesData->add(MonthlySales::fromExcel(\n $excelDataRow,\n $excelHeaderRow\n ));\n}\n```\n\n## Using `rangeToArray()`\n\nThe `toArray()` method uses information from the loaded file to identify the range of rows and columns to populate the array.\n`toArray()` uses two cached values to identify the range of cells to populate the array, values that are returned by the `getHighestRow()` and `getHighestColumn()` methods.\n\nBut many worksheets do have trailing empty rows (or columns); and it is quite common for an Excel spreadsheet to have only a few rows or columns of data, but for the spreadsheet itself to claim that the highest row is 1,048,576 or that the highest column is XFD.\nFeatures such as Data Validation or Conditional Formatting that can also artificially inflate/increase the values returned by `getHighestRow()` and `getHighestColumn()` methods.\n\nIf we use `toArray()` to build an array from the worksheet in this case, then it will build a 1,048,576x16,384 array, filled with null values, that will almost certainly exceed PHP's memory limits, and take a long time to do so.\nAnd if we do have enough memory to build the array, we will still be iterating over a lot more array entries than we want. Even if we're skipping empty rows, we're still testing every row to see if it's empty.\nWhere possible, it's better to specify the limit of rows and columns that we want to use to build an array, and PhpSpreadsheet provides the `rangeToArray()` for that purpose.\n\nOne option to reduce a large array using a lot of PHP memory would be to run a loop using `rangeToArray()` to build smaller arrays for blocks of perhaps 100 rows at a time.\nThis will still take a while to run if we have a lot of trailing empty rows, but it won't exceed PHP's memory limits.\n\n```php\n$startRow = 1;\n$batchSize = 100;\nwhile ($startRow <= $maxRow) {\n $endRow = min($startRow + $batchSize, $maxRow);\n $dataArray = $worksheet->rangeToArray(\"A{$startRow}:{$maxColumn}{$endRow}\");\n $startRow += $batchSize;\n\n foreach ($dataArray as $row) {\n // Check for empty rows\n if (count(array_filter($row, function ($value) {\n return $value !== null;\n })) === 0) {\n continue; // Ignore empty rows\n }\n\n foreach ($row as $cellValue) {\n // Do something with the cell data here.\n }\n }\n}\n```\n\nAlternatively, we can identify the highest row and highest column that actually contain cell data using the `getHighestDataRow()` and `getHighestDataColumn()` methods. This allows us to specify a range to pass to the `rangeToArray()` method.\n\n```php\n$maxDataRow = $worksheet->getHighestDataRow();\n$maxDataColumn = $worksheet->getHighestDataColumn();\n\n$dataArray = $worksheet->rangeToArray(\"A1:{$maxDataColumn}{$maxDataRow}\");\n\nforeach ($dataArray as $row) {\n // Check for empty rows\n if (count(array_filter($row, function ($value) {\n return $value !== null;\n })) === 0) {\n continue; // Ignore empty rows\n }\n\n foreach ($row as $cellValue) {\n // Do something with the cell data here.\n }\n}\n```\n\nThere might still be some empty rows in this array, so we still want to test for empty rows; but we won't have any trailing empty rows at the end of our data, so the iteration will terminate at the end of our specified row range, when we know we have no further data.\n\nAnd if there is a row or two of column headers that we want to ignore, we can modify the specified range to exclude them by adjusting the starting row of the range (e.g. `\"A3:{$maxDataColumn}{$maxDataRow}\"`);\n\nBecause we're only building the array for a specified range of rows and columns, the array that the method builds will often be smaller than the array created by `toArray()`, using less memory; and it will often be faster iterating just the subset of rows that we've requested.\n\n\nA combination of these approaches - batching and using the 'getHighestDataRow()' value, will be more memory-efficient, and possibly faster, than using 'toArray()'.\n```php\n$startRow = 1;\n$batchSize = 100;\nwhile ($startRow <= $maxDataRow) {\n $endRow = min($startRow + $batchSize, $maxDataRow);\n $dataArray = $worksheet->rangeToArray(\"A{$startRow}:{$maxDataColumn}{$endRow}\");\n $startRow += $batchSize;\n\n foreach ($dataArray as $row) {\n // Check for empty rows\n if (count(array_filter($row, function ($value) {\n return $value !== null;\n })) === 0) {\n continue; // Ignore empty rows\n }\n\n foreach ($row as $cellValue) {\n // Do something with the cell data here.\n }\n }\n}\n```\nHow does this approach compare with using 'toArray()' in terms of memory and speed? Here are the details for using `rangeToArray()` with a batched approach:\n```\nCurrent memory usage: 47104 KB\n\nCall time to batch iterate array rows was 0.6844 seconds\n Current memory usage: 47104 KB\n Peak memory usage: 49152 KB\n```\nWhile the total time is 0.6844 seconds, that included building the smaller batched arrays, so its speed is comparable to the total time of 0.6733 seconds using `toArray()`.\nBut a peak memory usage of 49,152KB compared with the 57,344KB used by `toArray()` make this approach a lot more memory efficient.\n\nLike `toArray()`, `rangeToArray()` is easy to use, but it has the same limitations for flexibility. It provides the same limited control over how the data from each cell is returned in the array as `toArray()`.\nThe same additional arguments that can be provided for the `toArray()` method can also be provided to `rangeToArray()`.\n\n\n## Using `rangeToArrayYieldRows()`\n\nSince v2.1.0 the worksheet method `rangeToArrayYieldRows()` is available.\nIt allows you to iterate over all sheet's rows with little memory consumption,\nwhile obtaining each row as an array:\n\n```php\n$rowGenerator = $sheet->rangeToArrayYieldRows(\n 'A1:' . $sheet->getHighestDataColumn() . $sheet->getHighestDataRow(),\n null,\n false,\n false\n);\nforeach ($rowGenerator as $row) {\n echo $row[0] . ' | ' . $row[1] . \"\\n\";\n}\n```\n\nSee `samples/Reader2/23_iterateRowsYield.php`.\n\n\n## Using Iterators\n\nYou don't need to build an array from the worksheet to loop through the rows and columns and do whatever processing you need; you can loop through the rows and columns in the Worksheet directly and more efficiently using PhpSpreadsheet's built-in iterators.\n\nAnd this also gives a lot more flexibility in how you can present the cell values, because the iterator will return the Cell itself, not a representation of its value. You can read its value, check its style, identify if it is part of a merge range.\n\n```php\n$rowIterator = $worksheet->getRowIterator();\nforeach ($rowIterator as $row) {\n $columnIterator = $row->getCellIterator();\n foreach ($columnIterator as $cell) {\n // Do something with the cell here.\n }\n}\n```\n\nLet's look at the memory usage and timings for using PhpSpreadsheet's Iterators, as we did for building and iterating through the array.\n\n```\nCurrent memory usage: 47104 KB\n\nCall time to iterate rows was 0.0930 seconds\n Current memory usage: 47104 KB\n Peak memory usage: 47104 KB\n```\n\nUsing the PhpSpreadsheet Iterators isn't as fast as iterating over an array; but it doesn't have the time or memory overheads of actually building that array from the worksheet.\nUsing the same example spreadsheet, it only took 0.0130 seconds to iterate every cell of that array, but 0.6603 seconds to build the array, a total of 0.6733 seconds; but using the Iterator has performed the equivalent task in just 0.0930 seconds; about 7 times faster and without the increased memory overhead of the array.\n\n### Dealing with empty rows\n\nAs, when we were iterating over the array, we might want to identify empty rows so that we can avoid trying to process them. The Row Iterator provides a method to identify empty rows.\n\n```php\n$rowIterator = $worksheet->getRowIterator();\nforeach ($rowIterator as $row) {\n if ($row->isEmpty()) { // Ignore empty rows\n continue;\n }\n\n $columnIterator = $row->getCellIterator();\n foreach ($columnIterator as $cell) {\n // Do something with the cell here.\n }\n}\n```\n\nOne additional feature when using the Iterator to determine whether a row is empty or not is that we can set our own rules to define \"empty\".\nThe default rule is if there is no entry for the Cell in the Cell Collection.\nIf we also want to skip any Cell that contains a null value, then we can pass an argument using the pre-defined constant `CellIterator::TREAT_NULL_VALUE_AS_EMPTY_CELL`.\nIf we also want to skip any Cell that contains an empty string, then we can pass an argument using the pre-defined constant `CellIterator::TREAT_EMPTY_STRING_AS_EMPTY_CELL`.\n\nAnd we can combine those rules:\n```php\nif ($row->isEmpty(\n CellIterator::TREAT_EMPTY_STRING_AS_EMPTY_CELL | \n CellIterator::TREAT_NULL_VALUE_AS_EMPTY_CELL)\n ) { // Ignore empty rows\n continue;\n}\n```\n\nSince PhpSpreadsheet 1.27.0, we can take this empty test one step further.\nIf we look at a slightly modified version of the Sales Data worksheet, rows 7 and 10 have no sales data, but they aren't empty because there is a month value in column A.\n\n\n\nBut we can tell the `isEmpty()` method to only check if a specified range of columns is empty in a row.\n\n```php\nif ($row->isEmpty(startColumn: 'B', endColumn: 'E') {\n // Ignore empty rows where columns B to E are empty values\n // even though there is a value in Column A.\n continue;\n}\n```\n\n---\n\nLike `toArray()`, the Iterators use the `getHighestRow()` and `getHighestColumn()` methods to identify the maximum row and column values for iterating; so it can still iterate over a lot of trailing empty rows and columns.\nBut that is just a default behaviour.\nSimilarly to `rangeToArray()` we can specify a range of rows, and a range of columns to iterate.\n\n```php\n$maxDataRow = $worksheet->getHighestDataRow();\n$maxDataColumn = $worksheet->getHighestDataColumn();\n\n$rowIterator = $worksheet->getRowIterator(1, $maxDataRow);\nforeach ($rowIterator as $row) {\n if ($row->isEmpty()) { // Ignore empty rows\n continue;\n }\n\n $columnIterator = $row->getCellIterator('A', $maxDataColumn);\n foreach ($columnIterator as $cell) {\n // Do something with the cell here.\n }\n}\n```\n\nand if we have heading rows at the top of the worksheet that we want to ignore:\n```php\n$rowIterator = $worksheet->getRowIterator(3, $maxDataRow);\n```\n\nAnd if we want to return only cells that aren't empty in the row, then we can tell the Cell Iterator to skip empty cells.\n\n```php\n$rowIterator = $worksheet->getRowIterator(1, $maxDataRow);\nforeach ($rowIterator as $row) {\n $columnIterator = $row->getCellIterator();\n $columnIterator->setIterateOnlyExistingCells(true);\n foreach ($columnIterator as $cell) {\n // Do something with the cell here.\n }\n}\n```\n\nAlongside the speed and memory benefits, another big advantage of using the Iterators (Row and Cell, or Column and Cell) is that we get direct access to the cell itself. We can look at its value, its style; we can identify if it is a formula, or formatted as a date/time, whether it is part of a merge range: we can choose exactly what we want to do with it.\n\n---\n\nOne drawback of the Cell Iterator is that it will create a new cell if none exists (by default) unless we're skipping empty cells.\nUntil PhpSpreadsheet 1.27.0, the Cell Iterator would always create a new Cell if one didn't exist in the Cell Collection when it was required to access it. And this can lead to increasing memory consumption.\n\nPhpSpreadsheet 1.27.0 introduced the option to return a null value rather than to create and return a new Cell.\n\n```php\n$rowIterator = $worksheet->getRowIterator(1, $maxDataRow);\nforeach ($rowIterator as $row) {\n $columnIterator = $row->getCellIterator();\n $columnIterator->setIfNotExists(CellIterator::IF_NOT_EXISTS_RETURN_NULL);\n foreach ($columnIterator as $cell) {\n if ($cell !== null) {\n // Do something with the cell here.\n }\n }\n}\n```\n\nThe default Iterator behaviour is still to create a new Cell, to retain backward compatibility; but the option to return a null value instead of a new empty cell now exists.\n> **Note**: This default behaviour is likely to be reversed with the eventual release of PhpSpreadsheet 2.0, with a null value as the default return, but with the option to create a new empty cell.\n\n## Summary of Performance and Benefits\n\nSo here is a quick summary of timing and memory usage for the three different approaches to iterating through the rows and cells of the 7000 row sample worksheet.\n\nMemory usage is adjusted for the 47,104 KB baseline of the loaded file.\n\n| Approach | Total Time (s) | Memory (KB) |\n|------------------------|----------------|-------------|\n| toArray() | 0.6733 | 10,240 | \n| rangeToArray (Batched) | 0.6844 | 2,048 | \n| Iterators | 0.0930 | 0 | \n\nThese figures are all based on a well-formed spreadsheet, with no trailing empty rows, or empty rows within the dataset.\nEmpty rows within a dataset can be identified by all three approaches, although only Iterators have a built-in method to identify an empty row.\n\nUsing `toArray()` is not good for controlling memory usage, especially if there are trailing empty rows, so it should generally be avoided; but both `rangeToArray()` and the Iterators can exclude trailing rows by setting their scope based on the `getHighestDataRow()` and `getHighestDataColumn()` values.\n\nBatching rows with `rangeToArray()` is useful for keeping memory usage under control if you want to work with arrays.\n\nBut using the Iterators is significantly faster than either \"array\" approach, with no memory overhead (especially if using the option of a null return for Cells that don't exist that was made available in PhpSpreadsheet 1.27.0); and as the Iterators return the Cell object rather than simply a cell value, they provide a lot more flexibility in how to process that cell.\nThe flexibility to configure the definition of an empty row may also be useful to developers using this approach to iterating through a worksheet.\n\n## Conclusions\n\nWhile it might require a little more userland code by developers using PhpSpreadsheet; because they are faster, have no additional memory overhead, and provide more flexibility, Iterators are the recommended approach for looping through the rows (and cells) of a worksheet.\n\n" }, { "path": "docs/topics/The Dating Game.md", "content": "# The Dating Game\n\nDate and Time values are stored in different ways in spreadsheet files, depending on the file format; but internally when working in Excel the cell always contains a numeric value, representing the number of days since a baseline date, and formatted to appear as a human-readable date using a \"Number Format Mask\". This number is sometimes referred to as a serialized Excel date or timestamp.\n\n## Dates\n\nThat baseline date is normally 1st January 1900, although it can be 1st January 1904 (if the original spreadsheet file was created using the Mac version of MS Excel). Excel maintains a flag in the file indicating which baseline should be used; for file formats that don't provide this flag (such as .slk or .csv), the calendar defaults to the 1900 baseline.\n\n\nNote that the baseline date itself is day 1; so strictly speaking, the base date 0 is '1899-12-31': Excel considers any value between 0 and 1 as purely a time value, trying to display 0 using a date format mask like 'yyyy-mm-dd' will show an invalid date like '1900-01-00' rather than '1899-12-31', but when using a time format mask like 'hh:mm:ss' it will appear as '00:00:00' (midnight). Values less than 0 are invalid as dates or as times, so a negative value in a cell with a date \"Number Format Mask\" will display as '############' in Excel.\n\nOpen/Libre Office and Gnumeric don't have this limitation, and negative date/timestamp values are recognised and formatted correctly; but it is recommended that you don't rely on this when working with PhpSpreadsheet.\n\nTo write a date in a cell using PhpSpreadsheet, we need to calculate the serialized Excel datestamp for that date. Methods to do this are available in the Shared\\Date class, which provides a number of methods for conversion between different date options typically used in PHP applications (Unix timestamp, PHP DateTime objects and some recognisable formatted strings) and the Excel serialized value; and vice versa.\n\n - Shared\\Date::convertIsoDate()\n - Converts a date/time in [ISO-8601 standard format](https://en.wikipedia.org/wiki/ISO_8601) to an Excel serialized timestamp\n - Shared\\Date::PHPToExcel()\n - Converts a Unix timestamp, a PHP DateTime object, or a recognisable formatted string to an Excel serialized timestamp\n - Shared\\Date::dateTimeToExcel()\n - Converts a Unix timestamp to an Excel serialized timestamp\n - Shared\\Date::timestampToExcel()\n - Converts a PHP DateTime object to an Excel serialized timestamp\n - Shared\\Date::formattedPHPToExcel()\n - Converts year, month, day, hour, minute, and second to an Excel serialized timestamp\n - Shared\\Date::excelToDateTimeObject()\n - Converts an Excel serialized timestamp to a PHP DateTime object\n - Shared\\Date::excelToTimestamp()\n - Converts an Excel serialized timestamp to a Unix timestamp.\n - The use of Unix timestamps, and therefore this function, is discouraged: they are not Y2038-safe on a 32-bit system, and have no timezone info.\n\nWe probably also want to set the number format mask for the cell so that it will be displayed as a human-readable date.\n```php\nuse PhpOffice\\PhpSpreadsheet\\Spreadsheet;\nuse PhpOffice\\PhpSpreadsheet\\Shared\\Date as SharedDate;\n\n// Create new Spreadsheet object\n$spreadsheet = new Spreadsheet();\n$worksheet = $spreadsheet->getActiveSheet();\n\n// Calculate today's date as an Excel serialized timestamp\n$today = SharedDate::PHPToExcel(new DateTime('today'));\n\n$data = [\n ['Formatted Date', 'Numeric Value'],\n ['=C2', 1],\n ['=C3', 2],\n ['=C4', $today],\n];\n\n// Write our data to the worksheet\n$worksheet->fromArray($data, null, 'B1');\n\n// Display values in column B as human-readable dates\n$worksheet->getStyle('B2:B4')->getNumberFormat()->setFormatCode('yyyy-mm-dd');\n// Set some additional styling\n$worksheet->getStyle('B1:C1')->getFont()->setBold(true);\n$worksheet->getColumnDimension('B')->setAutoSize(true);\n```\n\n## Times\n\nDates are always the integer part of the value (1, 2, 44943): the fractional part of the value is used to represent the time as a fraction of the day. So a value of 0.5 is 12:00 midday; 0.25 is 06:00 in the morning and 0.75 is 18:00 in the evening.\n\n\nA float value greater than 1, like 44943.5 is considered as a datetime value: 12:00 (midday) on the 17th of January 2023.\n\nAs with dates, to write a time value to a cell in PhpSpreadsheet, we write the numeric value for that time (or date/time) to the cell, and then apply a number format mask to the cell so that it will be displayed in a human-readable format.\n```php\nuse PhpOffice\\PhpSpreadsheet\\Spreadsheet;\nuse PhpOffice\\PhpSpreadsheet\\Shared\\Date as SharedDate;\n\n// Create new Spreadsheet object\n$spreadsheet = new Spreadsheet();\n$worksheet = $spreadsheet->getActiveSheet();\n\n// Calculate today's date as an Excel serialized timestamp\n$today = SharedDate::PHPToExcel(new DateTime('today'));\n\n$data = [\n ['Formatted Time', 'Numeric Value'],\n ['=C2', 0],\n ['=C3', 0.25],\n ['=C4', 0.5],\n ['=C5', 0.75],\n ['=C6', $today + 0.5],\n];\n\n// Write our data to the worksheet\n$worksheet->fromArray($data, null, 'B1', true);\n\n// Display values in column B as human-readable dates\n$worksheet->getStyle('B2:B5')->getNumberFormat()->setFormatCode('hh:mm:ss');\n$worksheet->getStyle('B6')->getNumberFormat()->setFormatCode('yyyy-mm-dd hh:mm:ss');\n// Set some additional styling\n$worksheet->getStyle('B1:C1')->getFont()->setBold(true);\n$worksheet->getColumnDimension('B')->setAutoSize(true);\n```\n\nThe same `Shared\\Date` functions that convert between Excel dates and Unix Timestamps or PHP DateTime objects can also be used to convert time values. \n\n## Dates/Times and Value Binders\n\nIt is a standing joke that MS Excel tries to identify date and time values as you are entering data in Excel, and often treats any value as a possible date, converting it to an Excel serialized timestamp and applying date/time formatting, even though that may not have been what was intended.\n\n\nAny change to a cell value in PhpSpreadsheet that isn't made using the setCellValueExplicit() method is passed through a \"Value Binder\", which triggers additional settings for that cell.\n\n> **Note**: dates and times maintained in true spreadsheet format files are always correctly identified in the file, and setCellValueExplicit() is used to store those values, with the formatting mask defined in that file. However, non-spreadsheet files such as .csv don't identify dates/times, so the Value Binder behaviour applies when loading those files.\n\n\nThe Default Value Binder attempts to identify the datatype of the value and sets the cell datatype accordingly: and if you pass a string value like '2023-01-18 12:15:00' then the Default Value Binder will simply treat it as a string, and set it accordingly.\n\nHowever, if you choose to use the Advanced Value Binder, then that contains logic which looks more closely at those string values, and tries to determine if they are likely to be formatted dates or times, and in that regard it emulates Excel's behaviour. If the string value looks like a date or time, then it is converted to a serialized Excel date/timestamp, and an appropriate format mask is set for that cell.\n\nWhile the logic of this isn't perfect, I'd like to believe that it is less error-prone than Excel's own logic; but it won't necessarily recognise ambiguous formats and values correctly like '1/7/2023' as dates. (Is that the 1st of July? Or the 7th of January?)\n\n## Reading Dates and Times from cells\n\nWhen we read the value of a cell that contains a Date/Time value, we are only reading a number (the Excel serialized timestamp); it is only the Number Format Mask that allows us to say whether that number is simply a number, or is meant to be a Date/Time value.\n\nPhpSpreadsheet provides a number of methods to identify whether a Number Format Mask represents a Date/Time format mask, or whether a Cell is formatted as a Date/Time.\n\n- Shared\\Date::isDateTimeFormat()\n - Identifies if a NumberFormat Style object is an Excel Date/Time style format mask.\n- Shared\\Date::isDateTimeFormatCode()\n - Identifies if the string value of a Number Format mask is an Excel Date/Time style format mask.\n- Shared\\Date::isDateTime()\n - Identifies if a Cell is styled with a Number Format mask is an Excel Date/Time style format mask.****\n\nThese functions allow you to identify whether a cell value should be converted to a Unix Timestamp or PHP DateTime object (using one of the conversion functions provided in `Shared\\Date`) for processing in your script, or for formatting as a Date/Time value.\n\n## Date Arithmetic\n\nBecause dates and times are just numeric values in MS Excel, this makes date/time arithmetic very easy to calculate: to count the number of days (or a duration) between two dates, we can use a simple subtraction.\n\n\nSimilarly, we can add date/time values like adding a duration to a start date to calculate an end date.\n\n\n## Excel Date Functions\n\nMS Excel provides a number of functions that will return a date or a time value. It also recognises when one of these functions is the \"outer\" function in a formula, so the final result will always be a serialized date/time value, and sets an appropriate format mask for that value.\n\nThis behaviour is not replicated in PhpSpreadsheet. If you set a formula for a cell through your code that will return a date or time value, then you will also need to set the format mask for that cell manually. \n\n## Formatting Options\n\nPhpSpreadsheet provides a number of built-in format code constants for dates and times in the NumberFormat class, matching those defined in the OfficeOpenXML specification, but you can always just set the format to any valid Excel formatting string, the equivalent of setting a custom date format in Excel.\n\n### Dates\n\nWhen setting up a custom date format in Excel, you can use the following codes.\n\n| Code | Description | Example (January 3, 2023) |\n|-------|-------------------------------------|---------------------------------------|\n| m | Month number without a leading zero | 1 |\n| mm | Month number with a leading zero | 01 |\n| mmm | Month name, short form | Jan |\n| mmmm | Month name, full form | January |\n| mmmmm | Month as the first letter | J (stands for January, June and July) |\n| d | Day number without a leading zero | 3 |\n| dd | Day number with a leading zero | 03 |\n| ddd | Day of the week, short form | Tue |\n| dddd | Day of the week, full form | Tuesday |\n| yy | Year (last 2 digits) | 23 |\n| yyyy | Year (4 digits) | 2023 |\n\n### Times\n\nWhen setting up a custom time format in Excel, you can use the following codes.\n\n| Code | Description | Displays as |\n|--------|--------------------------------------------------------------------|-------------|\n| h | Hours without a leading zero | 0-23 |\n| hh | Hours with a leading zero | 00-23 |\n| m | Minutes without a leading zero | 0-59 |\n| mm | Minutes with a leading zero | 00-59 |\n| s | Seconds without a leading zero | 0-59 |\n| ss | Seconds with a leading zero | 00-59 |\n| AM/PM | Periods of the day
(if omitted, 24-hour time format is used) | AM or PM |\n> **Warning**\nMS Excel allows any separator character between hours/minutes/seconds; PhpSpreadsheet currently requires a colon (`:`) to correctly distinguish minutes from months when rendering a time format within PHP code, although it will correctly write the format to file if any other separator character is used.\n\n### Duration (Elapsed Time)\n\nExcel also supports formatting a value as a duration; a total number of hours, minutes or seconds rather than a time of day. However, please note that negative durations are supported only if using base year 1904 (Mac default).\n\n| Code | Description | Displays as |\n|---------|----------------------------------------------------------------|-------------|\n| [h]:mm | Elapsed time in hours | e.g. 25:02 |\n| [hh]:mm | Elapsed time in hours
with a leading zero if less than 10 | e.g. 05:02 |\n| [mm]:ss | Elapsed time in minutes | e.g. 63:46 |\n| [m]:ss | Elapsed time in minutes
with a leading zero if less than 10 | e.g. 03:46 |\n| [s] | Elapsed time in seconds | |\n| [ss] | Elapsed time in seconds
with a leading zero if less than 10 | |\n\nIf you want to display an elapsed time in days, then you can use a normal date mask like `d h:mm` (without month or year), with the limitation that it will not exceed 31 days.\n\n### Localisation\n\n#### Built-in Formats\n\nSome of the Excel built-in format masks are locale-aware. \n\n\nThose locale-aware formats are highlighted with a * in Excel's drop-down lists for Date and Time, and will adapt when viewed in MS Excel, based on the locale settings of that local PC.\n\nPhpSpreadsheet is not locale-aware, so it will not render these formats as locale-formats, just as generic Date/Time formats; and localisation will be not be saved when writing to a spreadsheet file.\n\n#### Custom Formats\n\nWhen you're displaying a date/time using a format mask that isn't locale-aware in MS Excel, the locale settings for Excel are applied. So if you're displaying a month or day name, these will appear in the appropriate language for the locale of your PC.\n\n\nYou can force the display for a specific locale by prefixing the format mask with a locale setting, so that Excel will render it using the appropriate language. The locale code should be enclosed in [square brackets] and preceded with the dollar sign ($) and a dash (-).\n\nIn this example, I'm forcing Dutch Netherlands by prefixing the mask with `[$-nl-NL]`. As an alternative, I could also have used the Windows LCID for that locale (`[$-413]`).\n\n\nBecause PhpSpreadsheet is not locale-aware, displaying the formatted value for that cell in your PHP script won't show the locale date/time, only a generic date/time; but it will still be written correctly when the file is saved (as a spreadsheet format) for Excel to render correctly and in the appropriate language.\n\nIf you need this, then you can find a list of Windows LCID values [here](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-adts/a29e5c28-9fb9-4c49-8e43-4b9b8e733a05)\n\n## Summary Example\n\nLet's summarise some of this information with a script that will build a project timesheet for a week of work on that project.\n\nI'll keep the basic data in arrays for simplicity.\n```php\n// In a real application, we might read this data from a database to build a project timesheet\n$projectHeading = [['Project', 'PhpSpreadsheet - The Dating Game']];\n$weekHeading = [\n ['Week', '=ISOWEEKNUM(D3)', 'Start Date', '=DATE(2023,1,16)'],\n ['Day', 'Start Time', 'End Time', 'Hours Worked'],\n];\n\n$timesheetData = [\n ['2023-01-16', '17:25', '20:15'],\n ['2023-01-16', '20:50', '23:35'],\n ['2023-01-17', '18:10', '19:35'],\n ['2023-01-17', '20:10', '22:15'],\n ['2023-01-17', '22:35', '23:45'],\n ['2023-01-18', '09:15', '11:25'],\n];\n```\nBecause I've used string values for the dates and times, I'm going to use the Advanced Value Binder to populate the worksheet.\nThe Binder will also format the time values in columns B and C; but I want to override the Binder formatting for date values in column A; and I'm using an Excel formula for the \"start date\" value in cell D3, so I have to set the format manually for that.\n```php\nuse PhpOffice\\PhpSpreadsheet\\Spreadsheet;\nuse PhpOffice\\PhpSpreadsheet\\Cell\\Cell;\nuse PhpOffice\\PhpSpreadsheet\\Cell\\AdvancedValueBinder;\nuse PhpOffice\\PhpSpreadsheet\\Style\\Alignment;\n\n// Create new Spreadsheet object\n$spreadsheet = new Spreadsheet();\n$worksheet = $spreadsheet->getActiveSheet();\n// Use the Advanced Value Binder so that our string date/time values will be automatically converted\n// to Excel serialized date/timestamps\n// Old method using static property\nCell::setValueBinder(new AdvancedValueBinder());\n// Preferred method using dynamic property since 3.4.0\n$spreadsheet->setValueBinder(new AdvancedValueBinder());\n\n// Write our data to the worksheet\n$worksheet->fromArray($projectHeading);\n$worksheet->fromArray($weekHeading, null, 'A3');\n\n// Let Excel calculate the duration for each timesheet entry\n$row = 4;\nforeach ($timesheetData as $timesheetEntry) {\n ++$row;\n $worksheet->fromArray($timesheetEntry, null, \"A{$row}\");\n $worksheet->setCellValue(\"D{$row}\", \"=C{$row} - B{$row}\");\n}\n$totalRow = $row + 2;\n$worksheet->setCellValue(\"D{$totalRow}\", \"=SUM(D4:D{$row})\");\n$worksheet->setCellValue(\"E{$totalRow}\", 'Total Hours');\n```\nAnd then the final formatting:\n```php\n// Display values in column A as human-readable dates\n$worksheet->getStyle(\"A5:A{$row}\")->getNumberFormat()->setFormatCode('dd (ddd)');\n// Display values in column D as human-readable durations\n$worksheet->getStyle(\"D5:D{$totalRow}\")->getNumberFormat()->setFormatCode('[h]:mm');\n\n// Set some additional styling\n$worksheet->getStyle('D3')->getNumberFormat()->setFormatCode('yyyy-mm-dd');\n$worksheet->getStyle('A1')->getFont()->setBold(true);\n$worksheet->getStyle('A3:D4')->getFont()->setBold(true);\n$worksheet->getStyle(\"A5:A{$row}\")->getAlignment()->setHorizontal(Alignment::HORIZONTAL_LEFT);\n$worksheet->getColumnDimension('D')->setAutoSize(true);\n$worksheet->getStyle(\"E{$totalRow}\")->getFont()->setBold(true);\n```\n\nAnd the resulting spreadsheet will look something like:\n\n\n## Final Notes\n\nMS Excel is not Timezone aware, nor does it have any logic for handling Daylight Savings.\n\nExcel functions like the NOW() function return the serialized timestamp of the current date and time. The date and time are provided by the operating system, and that determines, according to the time zone and date of the year if Daylight Saving Time is in effect. So functions like NOW() include any DST offset, because it is automatically included by the OS.\n" }, { "path": "docs/topics/accessing-cells.md", "content": "# Accessing cells\n\nAccessing cells in a Spreadsheet should be pretty straightforward. This\ntopic lists some of the options to access a cell.\nFor all of these, the cell can be accessed by coordinate (e.g. `B3`),\nby an array of column index (where A is 1) and row (e.g. `[2, 3]`),\nor as a CellAddress object (e.g. `new CellAddress('B3', /* optional */ $worksheet)`.\n\n## Setting a cell value\n\nSetting a cell value can be done using the worksheet's\n`setCellValue()` method.\n\n```php\n// Set cell A1 with a string value\n$spreadsheet->getActiveSheet()->setCellValue('A1', 'PhpSpreadsheet');\n\n// Set cell A2 with a numeric value\n$spreadsheet->getActiveSheet()->setCellValue([1, 2], 12345.6789);\n\n// Set cell A3 with a boolean value\n$spreadsheet->getActiveSheet()->setCellValue(new CellAddress('A3'), TRUE);\n\n// Set cell A4 with a formula\n$spreadsheet->getActiveSheet()->setCellValue(\n 'A4',\n '=IF(A3, CONCATENATE(A1, \" \", A2), CONCATENATE(A2, \" \", A1))'\n);\n```\n\nAlternatively, you can retrieve the cell object, and then call the\ncell’s `setValue()` method:\n\n```php\n$spreadsheet->getActiveSheet()\n ->getCell('B8')\n ->setValue('Some value');\n```\n\n### Creating a new Cell\n\nIf you make a call to `getCell()`, and the cell doesn't already exist, then\nPhpSpreadsheet will create that cell for you.\n\n### Copying a Cell's Value And Style Adjusting Formulas\n\nIf cell A1 contains `5`, cell A2 contains `10`, and cell `B1` contains `=A1`, the formula in B1 will be evaluated as `5`. In Excel, if you copy B1 to B2, B2 will wind up with the adjusted formula `=A2` and will be evaluated as 10. Until release 5.1.0, PhpSpreadsheet requires the program to perform its own formula adjustment. In 5.1.0, a new method is introduced to handle formula adjustments:\n```php\n$worksheet->copyformula($fromCell, $toCell);\n```\nThis will behave as Excel does. If $fromCell does not contain a formula, its contents will be copied as-is.\n\nIf you also want to copy $fromCell's style, as Excel does, you can use the following (available in all supported releases):\n```php\n$worksheet->duplicateStyle($fromCell->getStyle(), $toCell);\n```\n\n### BEWARE: Cells and Styles assigned to variables as a Detached Reference\n\nAs an \"in-memory\" model, PHPSpreadsheet can be very demanding of memory,\nparticularly when working with large spreadsheets. One technique used to\nreduce this memory overhead is cell caching, so cells are actually\nmaintained in a collection that may or may not be held in memory while you\nare working with the spreadsheet. Because of this, a call to `getCell()`\n(or any similar method) returns the cell data, and sets a cell pointer to that cell in the collection.\nWhile this is not normally an issue, it can become significant\nif you assign the result of a call to `getCell()` to a variable. Any\nsubsequent calls to retrieve other cells will change that pointer, although\nthe cell object will still retain its data values.\nThis is also true when assigning a variable to the result of `getStyle()`.\n\nWhat does this mean? Consider the following code:\n\n```php\n$spreadSheet = new Spreadsheet();\n$workSheet = $spreadSheet->getActiveSheet();\n\n// Set details for the formula that we want to evaluate, together with any data on which it depends\n$workSheet->fromArray(\n [1, 2, 3],\n null,\n 'A1'\n);\n\n$cellC1 = $workSheet->getCell('C1');\necho 'Value: ', $cellC1->getValue(), '; Address: ', $cellC1->getCoordinate(), PHP_EOL;\n\n$cellA1 = $workSheet->getCell('A1');\necho 'Value: ', $cellA1->getValue(), '; Address: ', $cellA1->getCoordinate(), PHP_EOL;\n\necho 'Value: ', $cellC1->getValue(), '; Address: ', $cellC1->getCoordinate(), PHP_EOL;\n```\n\nThe call to `getCell('C1')` returns the cell at `C1` containing its value (`3`),\ntogether with its link to the collection (used to identify its\naddress/coordinate `C1`). The subsequent call to access cell `A1`\nmodifies the value of `$cellC1`, detaching its link to the collection.\n\nSo when we try to display the value and address a second time, we can display\nits value, but trying to display its address/coordinate will throw an\nexception because that link has been set to null.\n\n__Note:__ There are some internal methods that will fetch other cells from the\ncollection, and this too will detach the link to the collection from any cell\nthat you might have assigned to a variable.\n\n## Excel DataTypes\n\nMS Excel supports 7 basic datatypes:\n\n- string\n- number\n- boolean\n- null\n- formula\n- error\n- Inline (or rich text) string\n\nBy default, when you call the worksheet's `setCellValue()` method or the\ncell's `setValue()` method, PhpSpreadsheet will use the appropriate\ndatatype for PHP nulls, booleans, floats or integers; or cast any string\ndata value that you pass to the method into the most appropriate\ndatatype, so numeric strings will be cast to numbers, while string\nvalues beginning with `=` will be converted to a formula. Strings that\naren't numeric, or that don't begin with a leading `=` will be treated\nas genuine string values.\n\nNote that a numeric string that begins with a leading zero (that isn't\nimmediately followed by a decimal separator) will not be converted to a\nnumeric, so values like phone numbers (e.g. `01615991375``will remain as\nstrings).\n\nThis \"conversion\" is handled by a cell \"value binder\", and you can write\ncustom \"value binders\" to change the behaviour of these \"conversions\".\nThe standard PhpSpreadsheet package also provides an \"advanced value\nbinder\" that handles a number of more complex conversions, such as\nconverting strings with a fractional format like \"3/4\" to a number value\n(0.75 in this case) and setting an appropriate \"fraction\" number format\nmask. Similarly, strings like \"5%\" will be converted to a value of 0.05,\nand a percentage number format mask applied, and strings containing\nvalues that look like dates will be converted to Excel serialized\ndatetimestamp values, and a corresponding mask applied. This is\nparticularly useful when loading data from csv files, or setting cell\nvalues from a database.\n\nFormats handled by the advanced value binder include:\n\n- TRUE or FALSE (dependent on locale settings) are converted to booleans.\n- Numeric strings identified as scientific (exponential) format are\n converted to numbers.\n- Fractions and vulgar fractions are converted to numbers, and\n an appropriate number format mask applied.\n- Percentages are converted\n to numbers, divided by 100, and an appropriate number format mask\n applied.\n- Dates and times are converted to Excel timestamp values\n (numbers), and an appropriate number format mask applied.\n- When strings contain a newline character (`\\n`), then the cell styling is\n set to wrap.\n\nBasically, it attempts to mimic the behaviour of the MS Excel GUI.\n\nYou can read more about value binders [later in this section of the\ndocumentation](#using-value-binders-to-facilitate-data-entry).\n\n### Setting a formula in a Cell\n\nAs stated above, if you store a string value with the first character an `=`\nin a cell. PHPSpreadsheet will treat that value as a formula, and then you\ncan evaluate that formula by calling `getCalculatedValue()` against the cell.\n\nThere may be times though, when you wish to store a value beginning with `=`\nas a string, and that you don't want PHPSpreadsheet to evaluate as though it\nwas a formula.\n\nTo do this, you need to \"escape\" the value by setting it as \"quoted text\".\n\n```php\n// Set cell A4 with a formula\n$spreadsheet->getActiveSheet()->setCellValue(\n 'A4',\n '=IF(A3, CONCATENATE(A1, \" \", A2), CONCATENATE(A2, \" \", A1))'\n);\n$spreadsheet->getActiveSheet()->getCell('A4')\n ->getStyle()->setQuotePrefix(true);\n```\n\nThen, even if you ask PHPSpreadsheet to return the calculated value for cell\n`A4`, it will return `=IF(A3, CONCATENATE(A1, \" \", A2), CONCATENATE(A2, \" \", A1))`\nas a string, and not try to evaluate the formula.\n\n\n### Setting a date and/or time value in a cell\n\nDate or time values are held as timestamp in Excel (a simple floating\npoint value), and a number format mask is used to show how that value\nshould be formatted; so if we want to store a date in a cell, we need to\ncalculate the correct Excel timestamp, and set a number format mask.\n\n```php\n// Get the current date/time and convert to an Excel date/time\n$dateTimeNow = time();\n$excelDateValue = \\PhpOffice\\PhpSpreadsheet\\Shared\\Date::PHPToExcel( $dateTimeNow );\n// Set cell A6 with the Excel date/time value\n$spreadsheet->getActiveSheet()->setCellValue(\n 'A6',\n $excelDateValue\n);\n// Set the number format mask so that the excel timestamp will be displayed as a human-readable date/time\n$spreadsheet->getActiveSheet()->getStyle('A6')\n ->getNumberFormat()\n ->setFormatCode(\n \\PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat::FORMAT_DATE_DATETIME\n );\n```\n\n### Setting a number with leading zeroes\n\nBy default, PhpSpreadsheet will automatically detect the value type and\nset it to the appropriate Excel numeric datatype. This type conversion\nis handled by a value binder, as described in the section of this\ndocument entitled \"Using value binders to facilitate data entry\".\n\nNumbers don't have leading zeroes, so if you try to set a numeric value\nthat does have leading zeroes (such as a telephone number) then these\nwill be normally be lost as the value is cast to a number, so\n\"01513789642\" will be displayed as 1513789642.\n\nThere are two ways you can force PhpSpreadsheet to override this\nbehaviour.\n\nFirstly, you can set the datatype explicitly as a string so that it is\nnot converted to a number.\n\n```php\n// Set cell A8 with a numeric value, but tell PhpSpreadsheet it should be treated as a string\n$spreadsheet->getActiveSheet()->setCellValueExplicit(\n 'A8',\n \"01513789642\",\n \\PhpOffice\\PhpSpreadsheet\\Cell\\DataType::TYPE_STRING\n);\n```\n\nAlternatively, you can use a number format mask to display the value\nwith leading zeroes.\n\n```php\n// Set cell A9 with a numeric value\n$spreadsheet->getActiveSheet()->setCellValue('A9', 1513789642);\n// Set a number format mask to display the value as 11 digits with leading zeroes\n$spreadsheet->getActiveSheet()->getStyle('A9')\n ->getNumberFormat()\n ->setFormatCode(\n '00000000000'\n );\n```\n\nWith number format masking, you can even break up the digits into groups\nto make the value more easily readable.\n\n```php\n// Set cell A10 with a numeric value\n$spreadsheet->getActiveSheet()->setCellValue('A10', 1513789642);\n// Set a number format mask to display the value as 11 digits with leading zeroes\n$spreadsheet->getActiveSheet()->getStyle('A10')\n ->getNumberFormat()\n ->setFormatCode(\n '0000-000-0000'\n );\n```\n\n\n\n**Note:** that not all complex format masks such as this one will work\nwhen retrieving a formatted value to display \"on screen\", or for certain\nwriters such as HTML or PDF, but it will work with the true spreadsheet\nwriters (Xlsx and Xls).\n\n## Setting a range of cells from an array\n\nIt is also possible to set a range of cell values in a single call by\npassing an array of values to the `fromArray()` method.\n\n```php\n$arrayData = [\n [NULL, 2010, 2011, 2012],\n ['Q1', 12, 15, 21],\n ['Q2', 56, 73, 86],\n ['Q3', 52, 61, 69],\n ['Q4', 30, 32, 0],\n];\n$spreadsheet->getActiveSheet()\n ->fromArray(\n $arrayData, // The data to set\n NULL, // Array values with this value will not be set\n 'C3' // Top left coordinate of the worksheet range where\n // we want to set these values (default is A1)\n );\n```\n\n\n\nIf you pass a 2-d array, then this will be treated as a series of rows\nand columns. A 1-d array will be treated as a single row, which is\nparticularly useful if you're fetching an array of data from a database.\n\n```php\n$rowArray = ['Value1', 'Value2', 'Value3', 'Value4'];\n$spreadsheet->getActiveSheet()\n ->fromArray(\n $rowArray, // The data to set\n NULL, // Array values with this value will not be set\n 'C3' // Top left coordinate of the worksheet range where\n // we want to set these values (default is A1)\n );\n```\n\n\n\nIf you have a simple 1-d array, and want to write it as a column, then\nthe following will convert it into an appropriately structured 2-d array\nthat can be fed to the `fromArray()` method:\n\n```php\n$rowArray = ['Value1', 'Value2', 'Value3', 'Value4'];\n$columnArray = array_chunk($rowArray, 1);\n$spreadsheet->getActiveSheet()\n ->fromArray(\n $columnArray, // The data to set\n NULL, // Array values with this value will not be set\n 'C3' // Top left coordinate of the worksheet range where\n // we want to set these values (default is A1)\n );\n```\n\n\n\n## Retrieving a cell value\n\nTo retrieve the value of a cell, the cell should first be retrieved from\nthe worksheet using the `getCell()` method. A cell's value can be read\nusing the `getValue()` method.\n\n```php\n// Get the value from cell A1\n$cellValue = $spreadsheet->getActiveSheet()->getCell('A1')->getValue();\n```\n\nThis will retrieve the raw, unformatted value contained in the cell.\n\nIf a cell contains a formula, and you need to retrieve the calculated\nvalue rather than the formula itself, then use the cell's\n`getCalculatedValue()` method. This is further explained in\n[the calculation engine](./calculation-engine.md).\n\n```php\n// Get the value from cell A4\n$cellValue = $spreadsheet->getActiveSheet()->getCell('A4')->getCalculatedValue();\n```\n\nAlternatively, if you want to see the value with any cell formatting\napplied (e.g. for a human-readable date or time value), then you can use\nthe cell's `getFormattedValue()` method.\n\n```php\n// Get the value from cell A6\n$cellValue = $spreadsheet->getActiveSheet()->getCell('A6')->getFormattedValue();\n```\n\n## Retrieving a range of cell values to an array\n\nIt is also possible to retrieve a range of cell values to an array in a\nsingle call using the `toArray()`, `rangeToArray()` or\n`namedRangeToArray()` methods.\n\n```php\n$dataArray = $spreadsheet->getActiveSheet()\n ->rangeToArray(\n 'C3:E5', // The worksheet range that we want to retrieve\n NULL, // Value that should be returned for empty cells\n TRUE, // Should formulas be calculated (the equivalent of getCalculatedValue() for each cell)\n TRUE, // Should values be formatted (the equivalent of getFormattedValue() for each cell)\n TRUE // Should the array be indexed by cell row and cell column\n );\n```\n\nThese methods will all return a 2-d array of rows and columns. The\n`toArray()` method will return the whole worksheet; `rangeToArray()`\nwill return a specified range or cells; while `namedRangeToArray()` will\nreturn the cells within a defined `named range`.\n\n## Looping through cells\n\n### Looping through cells using iterators\n\nThe easiest way to loop cells is by using iterators. Using iterators,\none can use foreach to loop worksheets, rows within a worksheet, and\ncells within a row.\n\nBelow is an example where we read all the values in a worksheet and\ndisplay them in a table.\n\n```php\n$reader = \\PhpOffice\\PhpSpreadsheet\\IOFactory::createReader('Xlsx');\n$reader->setReadDataOnly(TRUE);\n$spreadsheet = $reader->load(\"test.xlsx\");\n\n$worksheet = $spreadsheet->getActiveSheet();\n\necho '
| ' .\n $cell->getValue() .\n ' | ' . PHP_EOL;\n }\n echo '
| ' . $value . ' | ' . PHP_EOL;\n }\n echo '
| ' .\n $worksheet->getCell($col . $row)\n ->getValue() .\n ' | ' . PHP_EOL;\n }\n echo '
![](\"./images/logo.jpg\"){kind=logo}
\n ```\n\nYou might want to see:\n\n```html\n![](\"http://www.domain.com/images/logo.jpg\"){kind=logo}
\n```\n\nYou can use the following code to achieve this result:\n\n```php\n$writer->setImagesRoot('http://www.example.com');\n```\n\n#### Formula pre-calculation\n\nBy default, this writer pre-calculates all formulas in the spreadsheet.\nThis can be slow on large spreadsheets, and maybe even unwanted. You can\nhowever disable formula pre-calculation:\n\n```php\n$writer = new \\PhpOffice\\PhpSpreadsheet\\Writer\\Html($spreadsheet);\n$writer->setPreCalculateFormulas(false);\n\n$writer->save(\"05featuredemo.htm\");\n```\n\n#### Embedding generated HTML in a web page\n\nThere might be a situation where you want to embed the generated HTML in\nan existing website. \\PhpOffice\\PhpSpreadsheet\\Writer\\Html provides\nsupport to generate only specific parts of the HTML code, which allows\nyou to use these parts in your website.\n\nSupported methods:\n\n- `generateHTMLHeader()`\n- `generateStyles()`\n- `generateSheetData()`\n- `generateHTMLFooter()`\n- `generateHTMLAll()`\n\nHere's an example which retrieves all parts independently and merges\nthem into a resulting HTML page:\n\n```php\n$writer = new \\PhpOffice\\PhpSpreadsheet\\Writer\\Html($spreadsheet);\n$hdr = $writer->generateHTMLHeader();\n$sty = $writer->generateStyles(false); // do not write \n$newstyle = <<| Hello World | \n
| Hello World | \n
| Hello World | \n
| Hello World | \n
| Hello World | \n
CHARTS | DATA
ONLY | IGNORE
EMPTY | IGNORE
ROWS | EXTERNAL
IMAGES |\n|----------|--------|------|--------|--------|--------|\n| Xlsx | YES | YES | YES | YES | YES |\n| Xls | NO | YES | YES | NO | NO |\n| Xml | NO | NO | NO | NO | NO |\n| Ods | NO | YES | NO | NO | NO |\n| Gnumeric | NO | YES | NO | NO | NO |\n| Html | N/A | N/A | N/A | N/A | YES |\n| Slk | N/A | NO | NO | NO | N/A |\n| Csv | N/A | NO | NO | NO | N/A |\n\nLikewise, when saving a file using a Writer, loaded charts will not be saved unless you explicitly tell the Writer to include them:\n\n```php\n$writer = IOFactory::createWriter($spreadsheet, 'Xlsx');\n$writer->setIncludeCharts(true);\n$writer->save('mySavedFileWithCharts.xlsx');\n```\n\nAs with the `load()` method, you can also pass flags in the `save()` method:\n```php\n$writer = IOFactory::createWriter($spreadsheet, 'Xlsx');\n$writer->save('mySavedFileWithCharts.xlsx', \\PhpOffice\\PhpSpreadsheet\\Writer\\IWriter::SAVE_WITH_CHARTS);\n```\n\nFlags that are available that can be passed to the Reader in this way include:\n\n- $reader::SAVE_WITH_CHARTS\n- $reader::DISABLE_PRECALCULATE_FORMULAE\n\n| Writers | SAVE_WITH_CHARTS | DISABLE_PRECALCULATE_FORMULAE |\n|---------|------------------|-------------------------------|\n| Xlsx | YES | YES |\n| Xls | NO | NO |\n| Ods | NO | YES |\n| Html | YES | YES |\n| Pdf | YES | YES |\n| Csv | N/A | YES |\n\n### Combining Flags\n\nOne benefit of flags is that you can pass several flags in a single method call.\nTwo or more flags can be passed together using PHP's `|` operator.\n\n```php\n$reader = \\PhpOffice\\PhpSpreadsheet\\IOFactory::createReaderForFile('myExampleFile.xlsx');\n$reader->load(\n 'spreadsheetWithCharts.xlsx',\n $reader::READ_DATA_ONLY | $reader::IGNORE_EMPTY_CELLS\n);\n```\n\n## Writing Data as a Plaintext Grid\n\nAlthough not really a spreadsheet format, it can be useful to write data in grid format to a plaintext file.\nCode like the following can be used:\n```php\n $array = $sheet->toArray(null, true, true, true);\n $textGrid = new \\PhpOffice\\PhpSpreadsheet\\Shared\\TextGrid(\n $array,\n true, // true for cli, false for html\n // Starting with release 4.2,\n // the output format can be tweaked by uncommenting\n // any of the following 3 optional parameters.\n // rowDividers: true,\n // rowHeaders: false,\n // columnHeaders: false,\n // Starting with release 5.4:\n // numbersRight: TextGridRightAlign::numeric,\n );\n $result = $textGrid->render();\n```\nYou can then echo `$result` to a terminal, or write it to a file with `file_put_contents`. The result will resemble:\n```\n +-----+------------------+---+----------+\n | A | B | C | D |\n+---+-----+------------------+---+----------+\n| 1 | 6 | 1900-01-06 00:00 | | 0.572917 |\n| 2 | 6 | TRUE | | 1<>2 |\n| 3 | xyz | xyz | | |\n+---+-----+------------------+---+----------+\n```\nPlease note that this may produce sub-optimal results for situations such as:\n\n- use of accents as combining characters rather than using pre-composed characters (may be handled by extending the class to override the `getString` or `strlen` methods)\n- Fullwidth characters\n- right-to-left characters (better display in a browser than a terminal on a non-RTL system)\n- multi-line strings\n" }, { "path": "docs/topics/reading-files.md", "content": "# Reading Files\n\n## Security\n\nXML-based formats such as OfficeOpen XML, Excel2003 XML, OASIS and\nGnumeric are susceptible to XML External Entity Processing (XXE)\ninjection attacks when reading spreadsheet files. This can lead to:\n\n- Disclosure whether a file is existent\n- Server Side Request Forgery\n- Command Execution (depending on the installed PHP wrappers)\n\nTo prevent this, by default every XML-based Reader looks for XML\nentities declared inside the DOCTYPE and if any is found an exception\nis raised.\n\nRead more [about of XXE injection](https://websec.io/2012/08/27/Preventing-XXE-in-PHP.html).\n\n## Loading a Spreadsheet File\n\nThe simplest way to load a workbook file is to let PhpSpreadsheet's IO\nFactory identify the file type and load it, calling the static `load()`\nmethod of the `\\PhpOffice\\PhpSpreadsheet\\IOFactory` class.\n\n```php\n$inputFileName = './sampleData/example1.xls';\n\n/** Load $inputFileName to a Spreadsheet Object **/\n$spreadsheet = \\PhpOffice\\PhpSpreadsheet\\IOFactory::load($inputFileName);\n```\n\nSee `samples/Reader/01_Simple_file_reader_using_IOFactory.php` for a working\nexample of this code.\n\nThe `load()` method will attempt to identify the file type, and\ninstantiate a loader for that file type; using it to load the file and\nstore the data and any formatting in a `Spreadsheet` object.\n\nThe method makes an initial guess at the loader to instantiate based on\nthe file extension; but will test the file before actually executing the\nload: so if (for example) the file is actually a CSV file or contains\nHTML markup, but that has been given a .xls extension (quite a common\npractise), it will reject the Xls loader that it would normally use for\na .xls file; and test the file using the other loaders until it finds\nthe appropriate loader, and then use that to read the file.\n\nIf you know that this is an `xls` file, but don't know whether it is a\ngenuine BIFF-format Excel or Html markup with an xls extension, you can\nlimit the loader to check only those two possibilities by passing in an\narray of Readers to test against.\n\n```php\n$inputFileName = './sampleData/example1.xls';\n$testAgainstFormats = [\n \\PhpOffice\\PhpSpreadsheet\\IOFactory::READER_XLS,\n \\PhpOffice\\PhpSpreadsheet\\IOFactory::READER_HTML,\n];\n\n/** Load $inputFileName to a Spreadsheet Object **/\n$spreadsheet = \\PhpOffice\\PhpSpreadsheet\\IOFactory::load($inputFileName, 0, $testAgainstFormats);\n```\n\nWhile easy to implement in your code, and you don't need to worry about\nthe file type; this isn't the most efficient method to load a file; and\nit lacks the flexibility to configure the loader in any way before\nactually reading the file into a `Spreadsheet` object.\n\n## Creating a Reader and Loading a Spreadsheet File\n\nIf you know the file type of the spreadsheet file that you need to load,\nyou can instantiate a new reader object for that file type, then use the\nreader's `load()` method to read the file to a `Spreadsheet` object. It is\npossible to instantiate the reader objects for each of the different\nsupported filetype by name. However, you may get unpredictable results\nif the file isn't of the right type (e.g. it is a CSV with an extension\nof .xls), although this type of exception should normally be trapped.\n\n```php\n$inputFileName = './sampleData/example1.xls';\n\n/** Create a new Xls Reader **/\n$reader = new \\PhpOffice\\PhpSpreadsheet\\Reader\\Xls();\n// $reader = new \\PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx();\n// $reader = new \\PhpOffice\\PhpSpreadsheet\\Reader\\Xml();\n// $reader = new \\PhpOffice\\PhpSpreadsheet\\Reader\\Ods();\n// $reader = new \\PhpOffice\\PhpSpreadsheet\\Reader\\Slk();\n// $reader = new \\PhpOffice\\PhpSpreadsheet\\Reader\\Gnumeric();\n// $reader = new \\PhpOffice\\PhpSpreadsheet\\Reader\\Csv();\n/** Load $inputFileName to a Spreadsheet Object **/\n$spreadsheet = $reader->load($inputFileName);\n```\n\nSee `samples/Reader/02_Simple_file_reader_using_a_specified_reader.php`\nfor a working example of this code.\n\nAlternatively, you can use the IO Factory's `createReader()` method to\ninstantiate the reader object for you, simply telling it the file type\nof the reader that you want instantiating.\n\n```php\n$inputFileType = 'Xls';\n// $inputFileType = 'Xlsx';\n// $inputFileType = 'Xml';\n// $inputFileType = 'Ods';\n// $inputFileType = 'Slk';\n// $inputFileType = 'Gnumeric';\n// $inputFileType = 'Csv';\n$inputFileName = './sampleData/example1.xls';\n\n/** Create a new Reader of the type defined in $inputFileType **/\n$reader = \\PhpOffice\\PhpSpreadsheet\\IOFactory::createReader($inputFileType);\n/** Load $inputFileName to a Spreadsheet Object **/\n$spreadsheet = $reader->load($inputFileName);\n```\n\nSee `samples/Reader/03_Simple_file_reader_using_the_IOFactory_to_return_a_reader.php`\nfor a working example of this code.\n\nIf you're uncertain of the filetype, you can use the `IOFactory::identify()`\nmethod to identify the reader that you need, before using the\n`createReader()` method to instantiate the reader object.\n\n```php\n$inputFileName = './sampleData/example1.xls';\n\n/**\n * Identify the type of $inputFileName.\n * See below for a possible improvement for release 4.1.0+.\n */\n$inputFileType = \\PhpOffice\\PhpSpreadsheet\\IOFactory::identify($inputFileName);\n/** Create a new Reader of the type that has been identified **/\n$reader = \\PhpOffice\\PhpSpreadsheet\\IOFactory::createReader($inputFileType);\n/** Load $inputFileName to a Spreadsheet Object **/\n$spreadsheet = $reader->load($inputFileName);\n```\n\nSee `samples/Reader/04_Simple_file_reader_using_the_IOFactory_to_identify_a_reader_to_use.php`\nfor a working example of this code.\n\nPrior to release 4.1.0, `identify` returns a file type.\nIt may be more useful to return a fully-qualified class name,\nwhich can be accomplished using a parameter introduced in 4.1.0:\n```php\n$inputFileType = \\PhpOffice\\PhpSpreadsheet\\IOFactory::identify($inputFileName, null, true);\n```\n\nAs with the IOFactory `load()` method, you can also pass an array of formats\nfor the `identify()` method to check against if you know that it will only\nbe in a subset of the possible formats that PhpSpreadsheet supports.\n\n```php\n$inputFileName = './sampleData/example1.xls';\n$testAgainstFormats = [\n \\PhpOffice\\PhpSpreadsheet\\IOFactory::READER_XLS,\n \\PhpOffice\\PhpSpreadsheet\\IOFactory::READER_HTML,\n];\n\n/** Identify the type of $inputFileName **/\n$inputFileType = \\PhpOffice\\PhpSpreadsheet\\IOFactory::identify($inputFileName, $testAgainstFormats);\n```\n\nYou can also use this to confirm that a file is what it claims to be:\n\n```php\n$inputFileName = './sampleData/example1.xls';\n\ntry {\n /** Verify that $inputFileName really is an Xls file **/\n $inputFileType = \\PhpOffice\\PhpSpreadsheet\\IOFactory::identify($inputFileName, [\\PhpOffice\\PhpSpreadsheet\\IOFactory::READER_XLS]);\n} catch (\\PhpOffice\\PhpSpreadsheet\\Reader\\Exception $e) {\n // File isn't actually an Xls file, even though it has an xls extension \n}\n```\n\n## Spreadsheet Reader Options\n\nOnce you have created a reader object for the workbook that you want to\nload, you have the opportunity to set additional options before\nexecuting the `load()` method.\n\nAll of these options can be set by calling the appropriate methods against the Reader (as described below), but some options (those with only two possible values) can also be set through flags, either by calling the Reader's `setFlags()` method, or passing the flags as an argument in the call to `load()`.\nThose options that can be set through flags are:\n\nOption | Flag | Default\n-------------------|-------------------------------------|------------------------\nEmpty Cells | IReader::IGNORE_EMPTY_CELLS | Load empty cells\nRows with no Cells | IReader::IGNORE_ROWS_WITH_NO_CELLS | Load rows with no cells\nData Only | IReader::READ_DATA_ONLY | Read data, structure and style\nCharts | IReader::LOAD_WITH_CHARTS | Don't read charts\n\nSeveral flags can be combined in a single call:\n```php\n$inputFileType = 'Xlsx';\n$inputFileName = './sampleData/example1.xlsx';\n\n/** Create a new Reader of the type defined in $inputFileType **/\n$reader = \\PhpOffice\\PhpSpreadsheet\\IOFactory::createReader($inputFileType);\n/** Set additional flags before the call to load() */\n$reader->setFlags(IReader::IGNORE_EMPTY_CELLS | IReader::LOAD_WITH_CHARTS);\n$reader->load($inputFileName);\n```\nor\n```php\n$inputFileType = 'Xlsx';\n$inputFileName = './sampleData/example1.xlsx';\n\n/** Create a new Reader of the type defined in $inputFileType **/\n$reader = \\PhpOffice\\PhpSpreadsheet\\IOFactory::createReader($inputFileType);\n/** Set additional flags in the call to load() */\n$reader->load($inputFileName, IReader::IGNORE_EMPTY_CELLS | IReader::LOAD_WITH_CHARTS);\n```\n\n### Ignoring Empty Cells\n\nMany Excel files have empty rows or columns at the end of a worksheet, which can't easily be seen when looking at the file in Excel (Try using Ctrl-End to see the last cell in a worksheet).\nBy default, PhpSpreadsheet will load these cells, because they are valid Excel values; but you may find that an apparently small spreadsheet requires a lot of memory for all those empty cells.\nIf you are running into memory issues with seemingly small files, you can tell PhpSpreadsheet not to load those empty cells using the `setReadEmptyCells()` method. \n\n```php\n$inputFileType = 'Xls';\n$inputFileName = './sampleData/example1.xls';\n\n/** Create a new Reader of the type defined in $inputFileType **/\n$reader = \\PhpOffice\\PhpSpreadsheet\\IOFactory::createReader($inputFileType);\n/** Advise the Reader that we only want to load cell's that contain actual content **/\n$reader->setReadEmptyCells(false);\n/** Load $inputFileName to a Spreadsheet Object **/\n$spreadsheet = $reader->load($inputFileName);\n```\n\nNote that cells containing formulae will still be loaded, even if that formula evaluates to a NULL or an empty string.\nSimilarly, Conditional Styling might also hide the value of a cell; but cells that contain Conditional Styling or Data Validation will always be loaded regardless of their value.\n\nThis option is available for the following formats:\n\nReader | Y/N |Reader | Y/N |Reader | Y/N |\n----------|:---:|--------|:---:|--------------|:---:|\nXlsx | YES | Xls | YES | Xml | NO |\nOds | NO | SYLK | NO | Gnumeric | NO |\nCSV | NO | HTML | NO\n\nThis option is also available through flags.\n\n### Ignoring Rows With No Cells\n\nSimilar to the previous item, you can choose to ignore rows which contain no cells.\nThis can also help with memory issues.\n```php\n$inputFileType = 'Xlsx';\n$inputFileName = './sampleData/example1.xlsx';\n\n/** Create a new Reader of the type defined in $inputFileType **/\n$reader = \\PhpOffice\\PhpSpreadsheet\\IOFactory::createReader($inputFileType);\n/** Advise the Reader that we do not want rows with no cells **/\n$reader->setIgnoreRowsWithNoCells(true);\n/** Load $inputFileName to a Spreadsheet Object **/\n$spreadsheet = $reader->load($inputFileName);\n```\n\nThis option is available only for Xlsx. It is also available through flags.\n\n### Reading Only Data from a Spreadsheet File\n\nIf you're only interested in the cell values in a workbook, but don't\nneed any of the cell formatting information, then you can set the reader\nto read only the data values and any formulae from each cell using the\n`setReadDataOnly()` method.\n\n```php\n$inputFileType = 'Xls';\n$inputFileName = './sampleData/example1.xls';\n\n/** Create a new Reader of the type defined in $inputFileType **/\n$reader = \\PhpOffice\\PhpSpreadsheet\\IOFactory::createReader($inputFileType);\n/** Advise the Reader that we only want to load cell data **/\n$reader->setReadDataOnly(true);\n/** Load $inputFileName to a Spreadsheet Object **/\n$spreadsheet = $reader->load($inputFileName);\n```\n\nSee `samples/Reader/05_Simple_file_reader_using_the_read_data_only_option.php`\nfor a working example of this code.\n\nIt is important to note that most Workbooks (and PhpSpreadsheet) store dates\nand times as simple numeric values: they can only be distinguished from\nother numeric values by the format mask that is applied to that cell.\nWhen setting read data only to true, PhpSpreadsheet doesn't read the\ncell format masks, so it is not possible to differentiate between\ndates/times and numbers.\n\nThe Gnumeric loader has been written to read the format masks for date\nvalues even when read data only has been set to true, so it can\ndifferentiate between dates/times and numbers; but this change hasn't\nyet been implemented for the other readers.\n\nReading Only Data from a Spreadsheet File applies to Readers:\n\nReader | Y/N |Reader | Y/N |Reader | Y/N |\n----------|:---:|--------|:---:|--------------|:---:|\nXlsx | YES | Xls | YES | Xml | YES |\nOds | YES | SYLK | NO | Gnumeric | YES |\nCSV | NO | HTML | NO\n\nThis option is also available through flags.\n\n### Reading Only Named WorkSheets from a File\n\nIf your workbook contains a number of worksheets, but you are only\ninterested in reading some of those, then you can use the\n`setLoadSheetsOnly()` method to identify those sheets you are interested\nin reading.\n\nTo read a single sheet, you can pass that sheet name as a parameter to\nthe `setLoadSheetsOnly()` method.\n\n```php\n$inputFileType = 'Xls';\n$inputFileName = './sampleData/example1.xls';\n$sheetname = 'Data Sheet #2';\n\n/** Create a new Reader of the type defined in $inputFileType **/\n$reader = \\PhpOffice\\PhpSpreadsheet\\IOFactory::createReader($inputFileType);\n/** Advise the Reader of which WorkSheets we want to load **/\n$reader->setLoadSheetsOnly($sheetname);\n/** Load $inputFileName to a Spreadsheet Object **/\n$spreadsheet = $reader->load($inputFileName);\n```\n\nSee `samples/Reader/07_Simple_file_reader_loading_a_single_named_worksheet.php`\nfor a working example of this code.\n\nIf you want to read more than just a single sheet, you can pass a list\nof sheet names as an array parameter to the `setLoadSheetsOnly()` method.\n\n```php\n$inputFileType = 'Xls';\n$inputFileName = './sampleData/example1.xls';\n$sheetnames = ['Data Sheet #1','Data Sheet #3'];\n\n/** Create a new Reader of the type defined in $inputFileType **/\n$reader = \\PhpOffice\\PhpSpreadsheet\\IOFactory::createReader($inputFileType);\n/** Advise the Reader of which WorkSheets we want to load **/\n$reader->setLoadSheetsOnly($sheetnames);\n/** Load $inputFileName to a Spreadsheet Object **/\n$spreadsheet = $reader->load($inputFileName);\n```\n\nSee `samples/Reader/08_Simple_file_reader_loading_several_named_worksheets.php`\nfor a working example of this code.\n\nTo reset this option to the default, you can call the `setLoadAllSheets()`\nmethod.\n\n```php\n$inputFileType = 'Xls';\n$inputFileName = './sampleData/example1.xls';\n\n/** Create a new Reader of the type defined in $inputFileType **/\n$reader = \\PhpOffice\\PhpSpreadsheet\\IOFactory::createReader($inputFileType);\n/** Advise the Reader to load all Worksheets **/\n$reader->setLoadAllSheets();\n/** Load $inputFileName to a Spreadsheet Object **/\n$spreadsheet = $reader->load($inputFileName);\n```\n\nSee `samples/Reader/06_Simple_file_reader_loading_all_worksheets.php` for a\nworking example of this code.\n\nReading Only Named WorkSheets from a File applies to Readers:\n\nReader | Y/N |Reader | Y/N |Reader | Y/N |\n----------|:---:|--------|:---:|--------------|:---:|\nXlsx | YES | Xls | YES | Xml | YES |\nOds | YES | SYLK | NO | Gnumeric | YES |\nCSV | NO | HTML | NO\n\n### Reading Only Specific Columns and Rows from a File (Read Filters)\n\nIf you are only interested in reading part of a worksheet, then you can\nwrite a filter class that identifies whether or not individual cells\nshould be read by the loader. A read filter must implement the\n`\\PhpOffice\\PhpSpreadsheet\\Reader\\IReadFilter` interface, and contain a\n`readCell()` method that accepts arguments of `$column`, `$row` and\n`$worksheetName`, and return a boolean true or false that indicates\nwhether a workbook cell identified by those arguments should be read or\nnot.\n\n```php\n$inputFileType = 'Xls';\n$inputFileName = './sampleData/example1.xls';\n$sheetname = 'Data Sheet #3';\n\n/** Define a Read Filter class implementing \\PhpOffice\\PhpSpreadsheet\\Reader\\IReadFilter */\nclass MyReadFilter implements \\PhpOffice\\PhpSpreadsheet\\Reader\\IReadFilter\n{\n public function readCell($columnAddress, $row, $worksheetName = '') {\n // Read rows 1 to 7 and columns A to E only\n if ($row >= 1 && $row <= 7) {\n if (in_array($columnAddress,range('A','E'))) {\n return true;\n }\n }\n return false;\n }\n}\n\n/** Create an Instance of our Read Filter **/\n$filterSubset = new MyReadFilter();\n\n/** Create a new Reader of the type defined in $inputFileType **/\n$reader = \\PhpOffice\\PhpSpreadsheet\\IOFactory::createReader($inputFileType);\n/** Tell the Reader that we want to use the Read Filter **/\n$reader->setReadFilter($filterSubset);\n/** Load only the rows and columns that match our filter to Spreadsheet **/\n$spreadsheet = $reader->load($inputFileName);\n```\n\nSee `samples/Reader/09_Simple_file_reader_using_a_read_filter.php` for a\nworking example of this code.\n\nThis example is not particularly useful, because it can only be used in\na very specific circumstance (when you only want cells in the range\nA1:E7 from your worksheet. A generic Read Filter would probably be more\nuseful:\n\n```php\n/** Define a Read Filter class implementing \\PhpOffice\\PhpSpreadsheet\\Reader\\IReadFilter */\nclass MyReadFilter implements \\PhpOffice\\PhpSpreadsheet\\Reader\\IReadFilter\n{\n private $startRow = 0;\n private $endRow = 0;\n private $columns = [];\n\n /** Get the list of rows and columns to read */\n public function __construct($startRow, $endRow, $columns) {\n $this->startRow = $startRow;\n $this->endRow = $endRow;\n $this->columns = $columns;\n }\n\n public function readCell($columnAddress, $row, $worksheetName = '') {\n // Only read the rows and columns that were configured\n if ($row >= $this->startRow && $row <= $this->endRow) {\n if (in_array($columnAddress,$this->columns)) {\n return true;\n }\n }\n return false;\n }\n}\n\n/** Create an Instance of our Read Filter, passing in the cell range **/\n$filterSubset = new MyReadFilter(9,15,range('G','K'));\n```\n\nSee `samples/Reader/10_Simple_file_reader_using_a_configurable_read_filter.php`\nfor a working example of this code.\n\nThis can be particularly useful for conserving memory, by allowing you\nto read and process a large workbook in \"chunks\": an example of this\nusage might be when transferring data from an Excel worksheet to a\ndatabase.\n\nRead Filtering does not renumber cell rows and columns. If you filter to read only rows 100-200, cells that you read will still be numbered A100-A200, not A1-A101. Cells A1-A99 will not be loaded, but if you then try to call `getCell()` for a cell outside your loaded range, then PHPSpreadsheet will create a new cell with a null value.\n\nMethods such as `toArray()` assume that all cells in a spreadsheet has been loaded from A1, so will return null values for rows and columns that fall outside your filter range: it is recommended that you keep track of the range that your filter has requested, and use `rangeToArray()` instead.\n\n```php\n$inputFileType = 'Xls';\n$inputFileName = './sampleData/example2.xls';\n\n/** Define a Read Filter class implementing \\PhpOffice\\PhpSpreadsheet\\Reader\\IReadFilter */\nclass ChunkReadFilter implements \\PhpOffice\\PhpSpreadsheet\\Reader\\IReadFilter\n{\n private $startRow = 0;\n private $endRow = 0;\n\n /** Set the list of rows that we want to read */\n public function setRows($startRow, $chunkSize) {\n $this->startRow = $startRow;\n $this->endRow = $startRow + $chunkSize;\n }\n\n public function readCell($columnAddress, $row, $worksheetName = '') {\n // Only read the heading row, and the configured rows\n if (($row == 1) || ($row >= $this->startRow && $row < $this->endRow)) {\n return true;\n }\n return false;\n }\n}\n\n/** Create a new Reader of the type defined in $inputFileType **/\n$reader = \\PhpOffice\\PhpSpreadsheet\\IOFactory::createReader($inputFileType);\n\n/** Define how many rows we want to read for each \"chunk\" **/\n$chunkSize = 2048;\n/** Create a new Instance of our Read Filter **/\n$chunkFilter = new ChunkReadFilter();\n\n/** Tell the Reader that we want to use the Read Filter **/\n$reader->setReadFilter($chunkFilter);\n\n/** Loop to read our worksheet in \"chunk size\" blocks **/\nfor ($startRow = 2; $startRow <= 65536; $startRow += $chunkSize) {\n /** Tell the Read Filter which rows we want this iteration **/\n $chunkFilter->setRows($startRow,$chunkSize);\n /** Load only the rows that match our filter **/\n $spreadsheet = $reader->load($inputFileName);\n // Do some processing here\n}\n```\n\nSee `samples/Reader/12_Reading_a_workbook_in_chunks_using_a_configurable_read_filter_`\nfor a working example of this code.\n\nUsing Read Filters applies to:\n\nReader | Y/N |Reader | Y/N |Reader | Y/N |\n----------|:---:|--------|:---:|--------------|:---:|\nXlsx | YES | Xls | YES | Xml | YES |\nOds | YES | SYLK | NO | Gnumeric | YES |\nCSV | YES | HTML | NO | | |\n\n### Combining Multiple Files into a Single Spreadsheet Object\n\nWhile you can limit the number of worksheets that are read from a\nworkbook file using the `setLoadSheetsOnly()` method, certain readers also\nallow you to combine several individual \"sheets\" from different files\ninto a single `Spreadsheet` object, where each individual file is a\nsingle worksheet within that workbook. For each file that you read, you\nneed to indicate which worksheet index it should be loaded into using\nthe `setSheetIndex()` method of the `$reader`, then use the\n`loadIntoExisting()` method rather than the `load()` method to actually read\nthe file into that worksheet.\n\n```php\n$inputFileType = 'Csv';\n$inputFileNames = [\n './sampleData/example1.csv',\n './sampleData/example2.csv'\n './sampleData/example3.csv'\n];\n\n/** Create a new Reader of the type defined in $inputFileType **/\n$reader = \\PhpOffice\\PhpSpreadsheet\\IOFactory::createReader($inputFileType);\n\n/** Extract the first named file from the array list **/\n$inputFileName = array_shift($inputFileNames);\n/** Load the initial file to the first worksheet in a `Spreadsheet` Object **/\n$spreadsheet = $reader->load($inputFileName);\n/** Set the worksheet title (to the filename that we've loaded) **/\n$spreadsheet->getActiveSheet()\n ->setTitle(pathinfo($inputFileName,PATHINFO_BASENAME));\n\n/** Loop through all the remaining files in the list **/\nforeach($inputFileNames as $sheet => $inputFileName) {\n /** Increment the worksheet index pointer for the Reader **/\n $reader->setSheetIndex($sheet+1);\n /** Load the current file into a new worksheet in Spreadsheet **/\n $reader->loadIntoExisting($inputFileName,$spreadsheet);\n /** Set the worksheet title (to the filename that we've loaded) **/\n $spreadsheet->getActiveSheet()\n ->setTitle(pathinfo($inputFileName,PATHINFO_BASENAME));\n}\n```\n\nSee `samples/Reader/13_Simple_file_reader_for_multiple_CSV_files.php` for a\nworking example of this code.\n\nNote that using the same sheet index for multiple sheets won't append\nfiles into the same sheet, but overwrite the results of the previous\nload. You cannot load multiple CSV files into the same worksheet.\n\nCombining Multiple Files into a Single Spreadsheet Object applies to:\n\nReader | Y/N |Reader | Y/N |Reader | Y/N |\n----------|:---:|--------|:---:|--------------|:---:|\nXlsx | NO | Xls | NO | Xml | NO |\nOds | NO | SYLK | YES | Gnumeric | NO |\nCSV | YES | HTML | NO\n\n### Combining Read Filters with the `setSheetIndex()` method to split a large CSV file across multiple Worksheets\n\nAn Xls BIFF .xls file is limited to 65536 rows in a worksheet, while the\nXlsx Microsoft Office Open XML SpreadsheetML .xlsx file is limited to\n1,048,576 rows in a worksheet; but a CSV file is not limited other than\nby available disk space. This means that we wouldn’t ordinarily be able\nto read all the rows from a very large CSV file that exceeded those\nlimits, and save it as an Xls or Xlsx file. However, by using Read\nFilters to read the CSV file in \"chunks\" (using the ChunkReadFilter\nClass that we defined in [the above section](#reading-only-specific-columns-and-rows-from-a-file-read-filters),\nand the `setSheetIndex()` method of the `$reader`, we can split the CSV\nfile across several individual worksheets.\n\n```php\n$inputFileType = 'Csv';\n$inputFileName = './sampleData/example2.csv';\n\necho 'Loading file ',pathinfo($inputFileName,PATHINFO_BASENAME),' using IOFactory with a defined reader type of ',$inputFileType,'
';\n/** Create a new Reader of the type defined in $inputFileType **/\n$reader = \\PhpOffice\\PhpSpreadsheet\\IOFactory::createReader($inputFileType);\n\n/** Define how many rows we want to read for each \"chunk\" **/\n$chunkSize = 65530;\n/** Create a new Instance of our Read Filter **/\n$chunkFilter = new ChunkReadFilter();\n\n/** Tell the Reader that we want to use the Read Filter **/\n/** and that we want to store it in contiguous rows/columns **/\n\n$reader->setReadFilter($chunkFilter)\n ->setContiguous(true);\n\n/** Instantiate a new Spreadsheet object manually **/\n$spreadsheet = new \\PhpOffice\\PhpSpreadsheet\\Spreadsheet();\n\n/** Set a sheet index **/\n$sheet = 0;\n/** Loop to read our worksheet in \"chunk size\" blocks **/\n/** $startRow is set to 2 initially because we always read the headings in row #1 **/\nfor ($startRow = 2; $startRow <= 1000000; $startRow += $chunkSize) {\n /** Tell the Read Filter which rows we want to read this loop **/\n $chunkFilter->setRows($startRow,$chunkSize);\n\n /** Increment the worksheet index pointer for the Reader **/\n $reader->setSheetIndex($sheet);\n /** Load only the rows that match our filter into a new worksheet **/\n $reader->loadIntoExisting($inputFileName,$spreadsheet);\n /** Set the worksheet title for the sheet that we've justloaded) **/\n /** and increment the sheet index as well **/\n $spreadsheet->getActiveSheet()->setTitle('Country Data #'.(++$sheet));\n}\n```\n\nSee `samples/Reader/14_Reading_a_large_CSV_file_in_chunks_to_split_across_multiple_worksheets.php`\nfor a working example of this code.\n\nThis code will read 65,530 rows at a time from the CSV file that we’re\nloading, and store each \"chunk\" in a new worksheet.\n\nThe `setContiguous()` method for the Reader is important here. It is\napplicable only when working with a Read Filter, and identifies whether\nor not the cells should be stored by their position within the CSV file,\nor their position relative to the filter.\n\nFor example, if the filter returned true for cells in the range B2:C3,\nthen with setContiguous set to false (the default) these would be loaded\nas B2:C3 in the `Spreadsheet` object; but with setContiguous set to\ntrue, they would be loaded as A1:B2.\n\nSplitting a single loaded file across multiple worksheets applies to:\n\nReader | Y/N |Reader | Y/N |Reader | Y/N |\n----------|:---:|--------|:---:|--------------|:---:|\nXlsx | NO | Xls | NO | Xml | NO |\nOds | NO | SYLK | NO | Gnumeric | NO |\nCSV | YES | HTML | NO\n\n### Pipe or Tab Separated Value Files\n\nThe CSV loader will attempt to auto-detect the separator used in the file. If it\ncannot auto-detect, it will default to the comma. If this does not fit your\nuse-case, you can manually specify a separator by using the `setDelimiter()`\nmethod.\n\n```php\n$inputFileType = 'Csv';\n$inputFileName = './sampleData/example1.tsv';\n\n/** Create a new Reader of the type defined in $inputFileType **/\n$reader = \\PhpOffice\\PhpSpreadsheet\\IOFactory::createReader($inputFileType);\n/** Set the delimiter to a TAB character **/\n$reader->setDelimiter(\"\\t\");\n// $reader->setDelimiter('|');\n\n/** Load the file to a Spreadsheet Object **/\n$spreadsheet = $reader->load($inputFileName);\n```\n\nSee `samples/Reader/15_Simple_file_reader_for_tab_separated_value_file_using_the_Advanced_Value_Binder.php`\nfor a working example of this code.\n\nIn addition to the delimiter, you can also use the following methods to\nset other attributes for the data load:\n\nMethod | Default\n-------------------|----------\nsetEnclosure() | `\"`\nsetInputEncoding() | `UTF-8`\n\nSetting CSV delimiter applies to:\n\nReader | Y/N |Reader | Y/N |Reader | Y/N |\n----------|:---:|--------|:---:|--------------|:---:|\nXlsx | NO | Xls | NO | Xml | NO |\nOds | NO | SYLK | NO | Gnumeric | NO |\nCSV | YES | HTML | NO\n\n\n### Reading formatted Numbers from a CSV File\n\nUnfortunately, numbers in a CSV file may be formatted as strings.\nIf that number is a simple integer or float (with a decimal `.` separator) without any thousands separator, then it will be treated as a number.\nHowever, if the value has a thousands separator (e.g. `12,345`), or a decimal separator that isn't a `.` (e.g. `123,45` for a European locale), then it will be loaded as a string with that formatting.\nIf you want the Csv Reader to convert that value to a numeric when it loads the file, the you need to tell it to do so. The `castFormattedNumberToNumeric()` lets you do this.\n\n(Assuming that our server is configured with German locale settings: otherwise it may be necessary to call `setlocale()` before loading the file.)\n```php\n$inputFileType = 'Csv';\n$inputFileName = './sampleData/example1.de.csv';\n\n/** It may be necessary to call setlocale() first if this is not your default locale */\n// setlocale(LC_ALL, 'de_DE.UTF-8', 'deu_deu');\n\n/** Create a new Reader of the type defined in $inputFileType **/\n$reader = \\PhpOffice\\PhpSpreadsheet\\IOFactory::createReader($inputFileType);\n/** Enable loading numeric values formatted with German , decimal separator and . thousands separator **/\n$reader->castFormattedNumberToNumeric(true);\n\n/** Load the file to a Spreadsheet Object **/\n$spreadsheet = $reader->load($inputFileName);\n```\nThis will attempt to load those formatted numeric values as numbers, based on the server's locale settings.\n\nIf you want to load those values as numbers, but also to retain the formatting as a number format mask, then you can pass a boolean `true` as a second argument to the `castFormattedNumberToNumeric()` method to tell the Reader to identify the format masking to use for that value. This option does have an arbitrary limit of 6 decimal places.\n\nIf your Csv file includes other formats for numbers (currencies, scientific format, etc); then you should probably also use the Advanced Value Binder to handle these cases. \n\nApplies to:\n\nReader | Y/N |Reader | Y/N |Reader | Y/N |\n----------|:---:|--------|:---:|--------------|:---:|\nXlsx | NO | Xls | NO | Xml | NO |\nOds | NO | SYLK | NO | Gnumeric | NO |\nCSV | YES | HTML | NO\n\n## A Brief Word about the Advanced Value Binder\n\nWhen loading data from a file that contains no formatting information,\nsuch as a CSV file, then data is read either as strings or numbers\n(float or integer). This means that PhpSpreadsheet does not\nautomatically recognise dates/times (such as `16-Apr-2009` or `13:30`),\nbooleans (`true` or `false`), percentages (`75%`), hyperlinks\n(`https://www.example.com`), etc as anything other than simple strings.\nHowever, you can apply additional processing that is executed against\nthese values during the load process within a Value Binder.\n\nA Value Binder is a class that implement the\n`\\PhpOffice\\PhpSpreadsheet\\Cell\\IValueBinder` interface. It must contain a\n`bindValue()` method that accepts a `\\PhpOffice\\PhpSpreadsheet\\Cell\\Cell` and a\nvalue as arguments, and return a boolean `true` or `false` that indicates\nwhether the workbook cell has been populated with the value or not. The\nAdvanced Value Binder implements such a class: amongst other tests, it\nidentifies a string comprising \"TRUE\" or \"FALSE\" (based on locale\nsettings) and sets it to a boolean; or a number in scientific format\n(e.g. \"1.234e-5\") and converts it to a float; or dates and times,\nconverting them to their Excel timestamp value – before storing the\nvalue in the cell object. It also sets formatting for strings that are\nidentified as dates, times or percentages. It could easily be extended\nto provide additional handling (including text or cell formatting) when\nit encountered a hyperlink, or HTML markup within a CSV file.\n\nSo using a Value Binder allows a great deal more flexibility in the\nloader logic when reading unformatted text files.\n\n```php\n$inputFileType = 'Csv';\n$inputFileName = './sampleData/example1.tsv';\n\n$reader = \\PhpOffice\\PhpSpreadsheet\\IOFactory::createReader($inputFileType);\n$reader->setDelimiter(\"\\t\");\n\n/** Tell PhpSpreadsheet that we want to use the Advanced Value Binder **/\n// Old method using static property\n\\PhpOffice\\PhpSpreadsheet\\Cell\\Cell::setValueBinder( new \\PhpOffice\\PhpSpreadsheet\\Cell\\AdvancedValueBinder() );\n// Preferred method using dynamic property since 3.4.0\n$reader::setValueBinder( new \\PhpOffice\\PhpSpreadsheet\\Cell\\AdvancedValueBinder() );\n\n$spreadsheet = $reader->load($inputFileName);\n```\n\nSee `samples/Reader/15_Simple_file_reader_for_tab_separated_value_file_using_the_Advanced_Value_Binder.php`\nfor a working example of this code.\n\nLoading using a Value Binder applies to:\n\nReader | Y/N |Reader | Y/N |Reader | Y/N\n----------|:---:|--------|:---:|--------------|:---:\nXlsx | NO | Xls | NO | Xml | NO\nOds | NO | SYLK | YES | Gnumeric | NO\nCSV | YES | HTML | YES\n\nNote that you can also use the Binder to determine how PhpSpreadsheet identified datatypes for values when you set a cell value without explicitly setting a datatype.\nValue Binders can also be used to set formatting for a cell appropriate to the value.\n\n## Error Handling\n\nOf course, you should always apply some error handling to your scripts\nas well. PhpSpreadsheet throws exceptions, so you can wrap all your code\nthat accesses the library methods within Try/Catch blocks to trap for\nany problems that are encountered, and deal with them in an appropriate\nmanner.\n\nThe PhpSpreadsheet Readers throw a\n`\\PhpOffice\\PhpSpreadsheet\\Reader\\Exception`.\n\n```php\n$inputFileName = './sampleData/example-1.xls';\n\ntry {\n /** Load $inputFileName to a Spreadsheet Object **/\n $spreadsheet = \\PhpOffice\\PhpSpreadsheet\\IOFactory::load($inputFileName);\n} catch(\\PhpOffice\\PhpSpreadsheet\\Reader\\Exception $e) {\n die('Error loading file: '.$e->getMessage());\n}\n```\n\nSee `samples/Reader/16_Handling_loader_exceptions_using_TryCatch.php` for a\nworking example of this code.\n\n## Helper Methods\n\nYou can retrieve a list of worksheet names contained in a file without\nloading the whole file by using the Reader’s `listWorksheetNames()`\nmethod; similarly, a `listWorksheetInfo()` method will retrieve the\ndimensions of worksheet in a file without needing to load and parse the\nwhole file.\n\n### listWorksheetNames\n\nThe `listWorksheetNames()` method returns a simple array listing each\nworksheet name within the workbook:\n\n```php\n$reader = \\PhpOffice\\PhpSpreadsheet\\IOFactory::createReader($inputFileType);\n\n$worksheetNames = $reader->listWorksheetNames($inputFileName);\n\necho '
Worksheet Names
';\necho '- ';\nforeach ($worksheetNames as $worksheetName) {\n echo '
- ', $worksheetName, ' ';\n}\necho '
Worksheet Information
';\necho '- ';\nforeach ($worksheetData as $worksheet) {\n echo '
- ', $worksheet['worksheetName'], '
';\n echo 'Rows: ', $worksheet['totalRows'],\n ' Columns: ', $worksheet['totalColumns'], '
';\n echo 'Cell Range: A1:',\n $worksheet['lastColumnLetter'], $worksheet['totalRows'], '
';\n echo 'Sheet state: ', $worksheet['sheetState'];\n echo ' ';\n}\necho '
\n
\n\nSetting spreadsheet metadata in PhpSpreadsheet is done as follows:\n\n```php\n$spreadsheet->getProperties()\n ->setCreator(\"Maarten Balliauw\")\n ->setLastModifiedBy(\"Mark Baker\")\n ->setTitle(\"Office 2007 XLSX Test Document\")\n ->setSubject(\"Office 2007 XLSX Test Document\")\n ->setDescription(\n \"Test document for Office 2007 XLSX, generated using PHP classes.\"\n )\n ->setKeywords(\"office 2007 openxml php\")\n ->setCategory(\"Test result file\");\n```\n\nYou can choose which properties to set or ignore.\n\nClick here for details of Spreadsheet Document Properties
\n\nThese are accessed in MS Excel from the \"Info\" option on the \"File\" menu:\n\n\nSome of these properties can be edited \"in situ\" in the Properties Block:\n\n\nFor more advanced properties, click on the \"Properties\" dropdown:\n\n\nAnd you will be able to add/edit/delete a lot of different property values.\n\n\nProperties on the \"General\", \"Statistics\" and \"Contents\" tabs are informational, and cannot be user-defined in Excel itself.\nProperties on the \"Summary\" tab are all string values.\n\nThe \"Custom\" tab allows you to define your own properties. More information from the Microsoft Documentation can be found [here](https://support.microsoft.com/en-us/office/view-or-change-the-properties-for-an-office-file-21d604c2-481e-4379-8e54-1dd4622c6b75).\n\n\nYou can select a property name from the dropdown, or type a new name of your choice; select a Type; enter a value; and then click on \"Add\".\nThe new property will then be created and displayed in the list at the bottom of the form.\n\nWhile \"Text\", \"Number\" (can be an integer or a floating point value) and \"Yes or No\" types are straightforward to add a value, \"Date\" types are more difficult, and Microsoft provide very little help.\nHowever, you need to enter the date in the format that matches your locale, so an American would enter \"7/4/2023 for the 4th of July; but in the UK I would enter \"4/7/2023\" for the same date.\nAlthough typically recognised as a date elsewhere in MS Excel, the almost universally recognised `2022-12-31` date format is not recognised as valid here.\n\n\n
setCreator() | |\n| Last Modified By | string | getLastModifiedBy()
setLastModifiedBy() | |\n| Created | float/int
timestamp | getCreated()
setCreated() | Cannot be modified in MS Excel; but is automatically set. |\n| Modified | float/int
timestamp | getModified()
setModified() | Cannot be modified in MS Excel; but is automatically set. |\n| Title | string | getTitle()
setTitle() | |\n| Description | string | getDescription()
setDescription() | |\n| Subject | string | getSubject()
setSubject() | |\n| Keywords | string | getKeywords()
setKeywords() | |\n| Category | string | getCategory()
setCategory() | Not supported in xls files. |\n| Company | string | getCompany()
setCompany() | Not supported in xls files. |\n| Manager | string | getManager()
setManager() | Not supported in xls files. |\n> **Note:** Not all Spreadsheet File Formats support all of these properties.\n> For example: \"Category\", \"Company\" and \"Manager\" are not supported in `xls` files.\n\n
\n\nClick here for details of Property Getters/Setters
\n\nPhpSpreadsheet provides specific getters/setters for a number of pre-defined properties.\n\n| Property Name | DataType | Getter/Setter | Notes |\n|------------------|-------------------------|----------------------------------------------|-----------------------------------------------------------|\n| Creator | string | getCreator()setCreator() | |\n| Last Modified By | string | getLastModifiedBy()
setLastModifiedBy() | |\n| Created | float/int
timestamp | getCreated()
setCreated() | Cannot be modified in MS Excel; but is automatically set. |\n| Modified | float/int
timestamp | getModified()
setModified() | Cannot be modified in MS Excel; but is automatically set. |\n| Title | string | getTitle()
setTitle() | |\n| Description | string | getDescription()
setDescription() | |\n| Subject | string | getSubject()
setSubject() | |\n| Keywords | string | getKeywords()
setKeywords() | |\n| Category | string | getCategory()
setCategory() | Not supported in xls files. |\n| Company | string | getCompany()
setCompany() | Not supported in xls files. |\n| Manager | string | getManager()
setManager() | Not supported in xls files. |\n> **Note:** Not all Spreadsheet File Formats support all of these properties.\n> For example: \"Category\", \"Company\" and \"Manager\" are not supported in `xls` files.\n\n
\n
\n Will return an array listing the names of all custom properties that are defined.\n - `isCustomPropertySet(string $propertyName)`
\n Will return a boolean indicating if the named custom property is defined.\n - `getCustomPropertyValue(string $propertyName)`
\n Will return the \"raw\" value of the named custom property; or null if the property doesn't exist.\n - `getCustomPropertyType(string $propertyName)`
\n Will return the datatype of the named custom property; or null if the property doesn't exist. \n - `setCustomProperty(string $propertyName, $propertyValue = '', $propertyType = null)`
\n Will let you set (or modify) a custom property. If you don't provide a datatype, then PhpSpreadsheet will attempt to identify the datatype from the value that you set.\n\nThe recognised Property Types are:\n\n| Constant | Datatype | Value |\n|-----------------------------------|----------|-------|\n| Properties::PROPERTY_TYPE_BOOLEAN | boolean | b |\n| Properties::PROPERTY_TYPE_INTEGER | integer | i |\n| Properties::PROPERTY_TYPE_FLOAT | float | f |\n| Properties::PROPERTY_TYPE_DATE | date | d |\n| Properties::PROPERTY_TYPE_STRING | string | s |\n\nWhen reading property types, you might also encounter:\n\n| Datatype | Value |\n|----------|--------------|\n| null | null value |\n| empty | empty string |\n| u | unknown |\n\nOther more complex types, such as pointers and filetime, are not supported by PhpSpreadsheet; and are discarded when reading a file.\n\n
\n\n```php\n$spreadsheet->getProperties()\n ->setCustomProperty('Editor', 'Mark Baker')\n ->setCustomProperty('Version', 1.17)\n ->setCustomProperty('Tested', true)\n ->setCustomProperty('Test Date', '2021-03-17', Properties::PROPERTY_TYPE_DATE);\n```\n> **Warning:** If the datatype for a date is not explicitly used, then it will be treated as a string.\n\n> **Note:** Although MS Excel doesn't recognise `2022-12-31` as valid date format when entering Custom Date Properties, PhpSpreadsheet will accept it.\n\n## Setting a spreadsheet's active sheet\n\nA Spreadsheet consists of (very rarely) none, one or more Worksheets. If you have 1 or more Worksheets, then one (and only one) of those Worksheets can be \"Active\" (viewed or updated) at a time, but there will always be an \"Active\" Worksheet (unless you explicitly delete all of the Worksheets in the Spreadsheet).\n\nClick here for details of Custom Properties
\n\nAdditionally, PhpSpreadsheet supports the creation and reading of custom properties for those file formats that accept custom properties.\nThe following methods of the Properties class can be used when working with custom properties.\n - `getCustomProperties()`\n Will return an array listing the names of all custom properties that are defined.\n - `isCustomPropertySet(string $propertyName)`
\n Will return a boolean indicating if the named custom property is defined.\n - `getCustomPropertyValue(string $propertyName)`
\n Will return the \"raw\" value of the named custom property; or null if the property doesn't exist.\n - `getCustomPropertyType(string $propertyName)`
\n Will return the datatype of the named custom property; or null if the property doesn't exist. \n - `setCustomProperty(string $propertyName, $propertyValue = '', $propertyType = null)`
\n Will let you set (or modify) a custom property. If you don't provide a datatype, then PhpSpreadsheet will attempt to identify the datatype from the value that you set.\n\nThe recognised Property Types are:\n\n| Constant | Datatype | Value |\n|-----------------------------------|----------|-------|\n| Properties::PROPERTY_TYPE_BOOLEAN | boolean | b |\n| Properties::PROPERTY_TYPE_INTEGER | integer | i |\n| Properties::PROPERTY_TYPE_FLOAT | float | f |\n| Properties::PROPERTY_TYPE_DATE | date | d |\n| Properties::PROPERTY_TYPE_STRING | string | s |\n\nWhen reading property types, you might also encounter:\n\n| Datatype | Value |\n|----------|--------------|\n| null | null value |\n| empty | empty string |\n| u | unknown |\n\nOther more complex types, such as pointers and filetime, are not supported by PhpSpreadsheet; and are discarded when reading a file.\n\n
\n
\n\nTo switch between Worksheets in MS Excel, you click on the Tab for the Worksheet that you want to be \"Active\" in the Worksheet Tab Bar. Excel will then set that as the \"Active\" Worksheet.\n\n\n\nIn PhpSpreadsheet, you do this by calling the Spreadsheet's `setActiveSheetIndex()` methods.\nEither:\n\n```php\n$activeWorksheet = $spreadsheet->setActiveSheetIndexByName('Sheet1')\n```\nusing the name/title of the Worksheet that you want as the \"Active\" Worksheet.\n\nOr:\n```php\n$activeWorksheet = $spreadsheet->setActiveSheetIndex(0);\n```\nWhere you set the \"Active\" Worksheet by its position in the Worksheet Tab Bar, with 0 as the first Worksheet, 1 as the second, etc.\n\nAnd you can then write values to Cells in `$activeWorksheet` (`Sheet1`) again.\n\n\nYou don't have to assign the return value from calls to `createSheet()` and `setActiveSheetIndex()` to a variable, but it means that you can call Worksheet methods directly against `$activeWorksheet`, rather than having to call `$spreadsheet->getActiveSheet()` all the time.\nAnd, unlike MS Excel where you can only update Cells in the \"Active\" Worksheet; PhpSpreadsheet allows you to update Cells in any Worksheet:\n```php\n// Create a Spreadsheet, with Worksheet Sheet1, which is the Active Worksheet\n$spreadsheet = new Spreadsheet();\n// Assign the Active Worksheet (Sheet1) to $worksheet1\n$worksheet1 = $spreadsheet->getActiveSheet();\n// Create a new Worksheet (Sheet2) and make that the Active Worksheet\n$worksheet2 = $spreadsheet->createSheet();\n\n$worksheet1->setCellValue('A1', 'I am a cell on Sheet1');\n$worksheet2->setCellValue('A1', 'I am a cell on Sheet2');\n```\n\n## Write a date or time into a cell\n\nIn Excel, dates and Times are stored as numeric values counting the\nnumber of days elapsed since 1900-01-01. For example, the date\n'2008-12-31' is represented as 39813. You can verify this in Microsoft\nOffice Excel by entering that date in a cell and afterwards changing the\nnumber format to 'General' so the true numeric value is revealed.\nLikewise, '3:15 AM' is represented as 0.135417.\n\nPhpSpreadsheet works with UST (Universal Standard Time) date and Time\nvalues, but does no internal conversions; so it is up to the developer\nto ensure that values passed to the date/time conversion functions are\nUST.\n\nWriting a date value in a cell consists of 2 lines of code. Select the\nmethod that suits you the best. Here are some examples:\n\n```php\n// MySQL-like timestamp '2008-12-31' or date string\n// Old method using static property\n\\PhpOffice\\PhpSpreadsheet\\Cell\\Cell::setValueBinder( new \\PhpOffice\\PhpSpreadsheet\\Cell\\AdvancedValueBinder() );\n// Preferred method using dynamic property since 3.4.0\n$spreadsheet->setValueBinder( new \\PhpOffice\\PhpSpreadsheet\\Cell\\AdvancedValueBinder() );\n\n$spreadsheet->getActiveSheet()\n ->setCellValue('D1', '2008-12-31');\n\n$spreadsheet->getActiveSheet()->getStyle('D1')\n ->getNumberFormat()\n ->setFormatCode(\\PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat::FORMAT_DATE_YYYYMMDDSLASH);\n\n// PHP-time (Unix time)\n$time = gmmktime(0,0,0,12,31,2008); // int(1230681600)\n$spreadsheet->getActiveSheet()\n ->setCellValue('D1', \\PhpOffice\\PhpSpreadsheet\\Shared\\Date::PHPToExcel($time));\n$spreadsheet->getActiveSheet()->getStyle('D1')\n ->getNumberFormat()\n ->setFormatCode(\\PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat::FORMAT_DATE_YYYYMMDDSLASH);\n\n// Excel-date/time\n$spreadsheet->getActiveSheet()->setCellValue('D1', 39813)\n$spreadsheet->getActiveSheet()->getStyle('D1')\n ->getNumberFormat()\n ->setFormatCode(\\PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat::FORMAT_DATE_YYYYMMDDSLASH);\n```\nThe above methods for entering a date all yield the same result.\nThe `\\PhpOffice\\PhpSpreadsheet\\Shared\\Date::PHPToExcel()` method will also\nwork with a PHP DateTime object; or with strings containing different well-recognised date formats\n(although this is limited in the same ways as using the Advanced Value Binder).\n\nSimilarly, times (or date and time values) can be entered in the same\nfashion: just remember to use an appropriate format code.\n\n> **Note:** See section \"Using value binders to facilitate data entry\" to learn more\nabout the AdvancedValueBinder used in the first example. Excel can also\noperate in a 1904-based calendar (default for workbooks saved on Mac).\nNormally, you do not have to worry about this when using PhpSpreadsheet.\n\n`\\PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat` provides a number of\npre-defined date formats; but this is just a string value, and you can\ndefine your own values as long as they are a valid MS Excel format.\nPhpSpreadsheet also provides a number of Wizards to help you create\nDate, Time and DateTime format masks.\n\nClick here for details about Worksheets
\n\nWhen you create a new Spreadsheet in MS Excel, it creates the Spreadsheet with a single Worksheet (\"Sheet1\")\n\n\n\nand that is the \"Active\" Worksheet.\n\n\n\nThis is the same as\n```php\n$spreadsheet = new Spreadsheet();\n$activeWorksheet = $spreadsheet->getActiveSheet();\n```\nin PhpSpreadsheet.\n\nAnd you can then write values to Cells in `$activeWorksheet` (`Sheet1`).\n\nTo create a new Worksheet in MS Excel, you click on the \"+\" button in the Worksheet Tab Bar. MS Excel will then create a new Worksheet (\"Sheet2\") in the Spreadsheet, and make that the current \"Active\" Worksheet.\n\n\n\nExcel always shows the \"Active\" Worksheet in the Grid, and you can see which Worksheet is \"Active\" because it is highlighted in the Worksheet Tab Bar at the bottom of the Worksheet Grid.\n\nThis is the same as\n```php\n$activeWorksheet = $spreadsheet->createSheet();\n```\nin PhpSpreadsheet.\n\nAnd you can then write values to Cells in `$activeWorksheet` (`Sheet2`).\n\n\n
\n\n## Write a formula into a cell\n\nInside the Excel file, formulas are always stored as they would appear\nin an English version of Microsoft Office Excel, and PhpSpreadsheet\nhandles all formulas internally in this format. This means that the\nfollowing rules hold:\n\n- Decimal separator is `.` (period)\n- Function argument separator is `,` (comma)\n- Matrix row separator is `;` (semicolon)\n- English function names must be used\n\nThis is regardless of which language version of Microsoft Office Excel\nmay have been used to create the Excel file.\n\nWhen the final workbook is opened by the user, Microsoft Office Excel\nwill take care of displaying the formula according the applications\nlanguage. Translation is taken care of by the application!\n\nThe following line of code writes the formula\n`=IF(C4>500,\"profit\",\"loss\")` into the cell B8. Note that the\nformula must start with `=` to make PhpSpreadsheet recognise this as a\nformula.\n\n```php\n$spreadsheet->getActiveSheet()->setCellValue('B8','=IF(C4>500,\"profit\",\"loss\")');\n```\n\nIf you want to write a string beginning with an `=` character to a\ncell, then you should use the `setCellValueExplicit()` method.\n\n```php\n$spreadsheet->getActiveSheet()\n ->setCellValueExplicit(\n 'B8',\n '=IF(C4>500,\"profit\",\"loss\")',\n \\PhpOffice\\PhpSpreadsheet\\Cell\\DataType::TYPE_STRING\n );\n```\n\nA cell's formula can be read again using the following line of code:\n\n```php\n$formula = $spreadsheet->getActiveSheet()->getCell('B8')->getValue();\n```\n\nIf you need the calculated value of a cell, use the following code. This\nis further explained in [the calculation engine](./calculation-engine.md).\n\n```php\n$value = $spreadsheet->getActiveSheet()->getCell('B8')->getCalculatedValue();\n```\n\n### Array Formulas\n\nWith version 3.0.0 of PhpSpreadsheet, we've introduced support for Excel \"array formulas\".\n**It is an opt-in feature.** You need to enable it with the following code:\n```php\n// preferred method\n\\PhpOffice\\PhpSpreadsheet\\Calculation\\Calculation::getInstance($spreadsheet)\n ->setInstanceArrayReturnType(\n \\PhpOffice\\PhpSpreadsheet\\Calculation\\Calculation::RETURN_ARRAY_AS_ARRAY);\n// or less preferred\n\\PhpOffice\\PhpSpreadsheet\\Calculation\\Calculation::setArrayReturnType(\n \\PhpOffice\\PhpSpreadsheet\\Calculation\\Calculation::RETURN_ARRAY_AS_ARRAY);\n```\nThis is not a new constant, and setArrayReturnType is also not new, but it has till now not had much effect.\nThe instance variable set by the new setInstanceArrayReturnType\nwill always be checked first, and the static variable used only if the instance variable is uninitialized.\n\nAs a basic example, let's look at a receipt for buying some fruit:\n\n\n\nWe can provide a \"Cost\" formula for each row of the receipt by multiplying the \"Quantity\" (column `B`) by the \"Price\" (column `C`); so for the \"Apples\" in row `2` we enter the formula `=$B2*$C2`. In PhpSpreadsheet, we would set this formula in cell `D2` using:\n```php\n$spreadsheet->getActiveSheet()->setCellValue('D2','=$B2*$C2');\n```\nand then do the equivalent for rows `3` to `6`.\n\nTo calculate the \"Total\", we would use a different formula, telling it to calculate the sum value of rows 2 to 6 in the \"Cost\" column:\n\n\n\nI'd imagine that most developers are familiar with this: we're setting a formula that uses an Excel function (the `SUM()` function) and specifying a range of cells to include in the sum (`$D$2:$D6`) \n```php\n$spreadsheet->getActiveSheet()->setCellValue('D7','=SUM($D$2:$D6');\n```\nHowever, we could have specified an alternative formula to calculate that result, using the arrays of the \"Quantity\" and \"Cost\" columns multiplied directly, and then summed together:\n\n\n\nEntering the formula `=SUM(B2:B6*C2:C6)` will calculate the same result; but because it's using arrays, we need to enter it as an \"array formula\". In MS Excel itself, we'd do this by using `Ctrl-Shift-Enter` rather than simply `Enter` when we define the formula in the formula edit box. MS Excel then shows that this is an array formula in the formula edit box by wrapping it in the `{}` braces (you don't enter these in the formula yourself; MS Excel does it).\n\n**In recent releases of Excel, Ctrl-Shift-Enter is not required, and Excel does not add the braces.\nPhpSpreadsheet will attempt to behave like the recent releases.**\n\nOr to identify the biggest increase in like-for-like sales from one month to the next:\n\n\n```php\n$spreadsheet->getActiveSheet()->setCellValue('F1','=MAX(B2:B6-C2:C6)');\n```\nWhich tells us that the biggest increase in sales between December and January was 30 more (in this case, 30 more Lemons).\n\n---\n\nThese are examples of array formula where the results are displayed in a single cell; but other array formulas might be displayed across several cells.\nAs an example, consider transposing a grid of data: MS Excel provides the `TRANSPOSE()` function for that purpose. Let's transpose our shopping list for the fruit:\n\n\n\nWhen we do this in MS Excel, we used to need to indicate ___all___ the cells that will contain the transposed data from cells `A1` to `D7`. We do this by selecting the cells where we want to display our transposed data either by holding the left mouse button down while we move with the mouse, or pressing `Shift` and using the arrow keys.\nOnce we've selected all the cells to hold our data, then we enter the formula `TRANSPOSE(A1:D7)` in the formula edit box, remembering to use `Ctrl-Shift-Enter` to tell MS Excel that this is an array formula. In recent Excel, you can just enter `=TRANSPOSE(A1:D7)` into cell A10.\n\nNote also that we still set this as the formula for the top-left cell of that range, cell `A10`.\n\nSimply setting an array formula in a cell and specifying the range won't populate the spillage area for that formula.\n```php\n$spreadsheet->getActiveSheet()\n ->setCellValue(\n 'A10',\n '=SEQUENCE(3,3)'\n );\n// Will return a null, because the formula for A1 hasn't been calculated to populate the spillage area \n$result = $spreadsheet->getActiveSheet()->getCell('C3')->getValue();\n```\nTo do that, we need to retrieve the calculated value for the cell.\n```php\n$spreadsheet->getActiveSheet()->getCell('A1')->getCalculatedValue();\n// Will return 9, because the formula for A1 has now been calculated, and the spillage area is populated \n$result = $spreadsheet->getActiveSheet()->getCell('C3')->getValue();\n```\nIf returning arrays has been enabled, `getCalculatedValue` will return an array when appropriate, and will populate the spill range. If returning arrays has not been enabled, when we call `getCalculatedValue()` for a cell that contains an array formula, PhpSpreadsheet will return the single value from the topmost leftmost cell, and will leave other cells unchanged.\n```php\n// Will return integer 1, the value for that cell within the array\n$a1result = $spreadsheet->getActiveSheet()->getCell('A1')->getCalculatedValue();\n```\n\n---\n\nExcel365 introduced a number of new functions that return arrays of results.\nThese include the `UNIQUE()`, `SORT()`, `SORTBY()`, `FILTER()`, `SEQUENCE()` and `RANDARRAY()` functions.\nWhile not all of these have been implemented by the Calculation Engine in PhpSpreadsheet, so they cannot all be calculated within your PHP applications, they can still be read from and written to Xlsx files.\n\nThe `SEQUENCE()` function generates a series of values (in this case, starting with `-10` and increasing in steps of `2.5`); and here we're telling the formula to populate a 3x3 grid with these values.\n\n\n\nNote that this is visually different from using `Ctrl-Shift-Enter` for the formula. When we are positioned in the \"spill\" range for the grid, MS Excel highlights the area with a blue border; and the formula displayed in the formula editing field isn't wrapped in braces (`{}`).\n\nAnd if we select any other cell inside the \"spill\" area other than the top-left cell, the formula in the formula edit field is greyed rather than displayed in black.\n\n\n\nWhen we enter this formula in MS Excel, we don't need to select the range of cells that it should occupy; nor do we need to enter it using `Ctrl-Shift-Enter`.\n\n### The Spill Operator\n\nIf you want to reference the entire spillage range of an array formula within another formula, you could do so using the standard Excel range operator (`:`, e.g. `A1:C3`); but you may not always know the range, especially for array functions that spill across as many cells as they need, like `UNIQUE()` and `FILTER()`.\nTo simplify this, MS Excel has introduced the \"Spill\" Operator (`#`).\n\n\n\nUsing our `SEQUENCE()`example, where the formula cell is `A1` and the result spills across the range `A1:C3`, we can use the Spill operator `A1#` to reference all the cells in that spillage range.\nIn this case, we're taking the absolute value of each cell in that range, and adding them together using the `SUM()` function to give us a result of 50. \n\nPhpSpreadsheet supports entry of a formula like this using the Spill operator. Alternatively, MS Excel internally implements the Spill Operator as a function (`ANCHORARRAY()`). MS Excel itself doesn't allow you to use this function in a formula, you have to use the \"Spill\" operator; but PhpSpreadsheet does allow you to use this internal Excel function. PhpSpreadsheet will convert the spill operator to ANCHORARRAY on write (so it may appear that your formula has changed, but it hasn't really); it is not necessary to convert it back on read.\n\nTo create this same function in PhpSpreadsheet, use:\n```php\n$spreadsheet->getActiveSheet()->setCellValue('D1','=SUM(ABS(ANCHORARRAY(A1)))');\n```\n\nWhen the file is saved, and opened in MS Excel, it will be rendered correctly.\n\n### The At-sign Operator\n\nIf you want to reference just the first cell of an array formula within another formula, you could do so by prefixing it with an at-sign. You can also select the entry in a range which matches the current row in this way; so, if you enter `=@A1:A5` in cell G3, the result will be the value from A3. MS Excel again implements this under the covers by converting to a function SINGLE. PhpSpreadsheet allows the use of the SINGLE function. It does not yet support the at-sign operator, which can have a different meaning in other contexts.\n\n### Updating Cell in Spill Area\n\nExcel prevents you from updating a cell in the spill area. PhpSpreadsheet does not - it seems like it might be quite expensive, needing to reevaluate the entire worksheet with each `setValue`. PhpSpreadsheet does provide a method to be used prior to calling `setValue` if desired.\n```php\n$sheet->setCellValue('A1', '=SORT{7;5;1}');\n$sheet->getCell('A1')->getCalculatedValue(); // populates A1-A3\n$sheet->isCellInSpillRange('A2'); // true\n$sheet->isCellInSpillRange('A3'); // true\n$sheet->isCellInSpillRange('A4'); // false\n$sheet->isCellInSpillRange('A1'); // false\n```\nThe last result might be surprising. Excel allows you to alter the formula cell itself, so `isCellInSpillRange` treats the formula cell as not in range. It should also be noted that, if array returns are not enabled, `isCellInSpillRange` will always return `false`.\n\n## Locale Settings for Formulas\n\nSome localisation elements have been included in PhpSpreadsheet. You can\nset a locale by changing the settings. To set the locale to Russian you\nwould use:\n\n```php\n$locale = 'ru';\n$validLocale = \\PhpOffice\\PhpSpreadsheet\\Settings::setLocale($locale);\nif (!$validLocale) {\n echo 'Unable to set locale to '.$locale.\" - reverting to en_usClick here for an example of the Date/Time Wizards
\n\n```php\nuse PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Date as DateWizard;\nuse PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Time as TimeWizard;\nuse PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\DateTime as DateTimeWizard;\n\n$spreadsheet->getActiveSheet()->setCellValue('A1', '=NOW()')\n$spreadsheet->getActiveSheet()->setCellValue('A2', '=NOW()')\n$spreadsheet->getActiveSheet()->setCellValue('A3', '=NOW()')\n\n// yyyy-mm-dd\n$dateFormat = new DateWizard(\n DateWizard::SEPARATOR_DASH,\n DateWizard::YEAR_FULL,\n DateWizard::MONTH_NUMBER_LONG,\n DateWizard::DAY_NUMBER_LONG\n);\n\n$spreadsheet->getActiveSheet()->getStyle('A1')\n ->getNumberFormat()\n ->setFormatCode($dateFormat);\n\n// hh:mm\n$timeFormat = new TimeWizard(\n TimeWizard::SEPARATOR_COLON,\n TimeWizard::HOURS_LONG,\n TimeWizard::MINUTES_LONG,\n);\n\n$spreadsheet->getActiveSheet()->getStyle('A2')\n ->getNumberFormat()\n ->setFormatCode($timeFormat);\n\n// yyyy-mm-dd hh:mm\n$dateTimeFormat = new DateTimeWizard(' ', $dateFormat, $timeFormat);\n\n$spreadsheet->getActiveSheet()->getStyle('A3')\n ->getNumberFormat()\n ->setFormatCode($dateTimeFormat);\n```\n\n\\n\";\n}\n```\n\nIf Russian language files aren't available, the `setLocale()` method\nwill return an error, and English settings will be used throughout.\n\nOnce you have set a locale, you can translate a formula from its\ninternal English coding.\n\n```php\n$formula = $spreadsheet->getActiveSheet()->getCell('B8')->getValue();\n$translatedFormula = \\PhpOffice\\PhpSpreadsheet\\Calculation\\Calculation::getInstance()->translateFormulaToLocale($formula);\n```\n\nYou can also create a formula using the function names and argument\nseparators appropriate to the defined locale; then translate it to\nEnglish before setting the cell value:\n\n```php\n$formula = '=ДНЕЙ360(ДАТА(2010;2;5);ДАТА(2010;12;31);ИСТИНА)';\n$internalFormula = \\PhpOffice\\PhpSpreadsheet\\Calculation\\Calculation::getInstance()->translateFormulaToEnglish($formula);\n$spreadsheet->getActiveSheet()->setCellValue('B8',$internalFormula);\n```\n\nCurrently, formula translation only translates the function names, the\nconstants TRUE and FALSE (and NULL), Excel error messages, and the function argument separators. Cell addressing using R1C1 formatting is not supported.\n\nAt present, the following locale settings are supported:\n\nLanguage | | Locale Code\n---------------------|----------------------|-------------\nBulgarian | български | bg\nCzech | Ceština | cs\nDanish | Dansk | da\nGerman | Deutsch | de\nSpanish | Español | es\nFinnish | Suomi | fi\nFrench | Français | fr\nHungarian | Magyar | hu\nItalian | Italiano | it\nDutch | Nederlands | nl\nNorwegian | Norsk Bokmål | nb\nPolish | Jezyk polski | pl\nPortuguese | Português | pt\nBrazilian Portuguese | Português Brasileiro | pt_br\nRussian | русский язык | ru\nSwedish | Svenska | sv\nTurkish | Türkçe | tr\n\nIf anybody can provide translations for additional languages, particularly Basque (Euskara), Catalan (Català), Croatian (Hrvatski jezik), Galician (Galego), Greek (Ελληνικά), Slovak (Slovenčina) or Slovenian (Slovenščina); please feel free to volunteer your services, and we'll happily show you what is needed to contribute a new language. \n\n## Write a newline character \"\\n\" in a cell (ALT+\"Enter\")\n\nIn Microsoft Office Excel you get a line break in a cell by hitting\nALT+\"Enter\". When you do that, it automatically turns on \"wrap text\" for\nthe cell.\n\nHere is how to achieve this in PhpSpreadsheet:\n\n```php\n$spreadsheet->getActiveSheet()->getCell('A1')->setValue(\"hello\\nworld\");\n$spreadsheet->getActiveSheet()->getStyle('A1')->getAlignment()->setWrapText(true);\n```\n\n**Tip**\n\nRead more about formatting cells using `getStyle()` elsewhere.\n\n**Tip**\n\nAdvancedValuebinder.php automatically turns on \"wrap text\" for the cell\nwhen it sees a newline character in a string that you are inserting in a\ncell. Just like Microsoft Office Excel. Try this:\n\n```php\n// Old method using static property\n\\PhpOffice\\PhpSpreadsheet\\Cell\\Cell::setValueBinder( new \\PhpOffice\\PhpSpreadsheet\\Cell\\AdvancedValueBinder() );\n// Preferred method using dynamic property since 3.4.0\n$spreadsheet->setValueBinder( new \\PhpOffice\\PhpSpreadsheet\\Cell\\AdvancedValueBinder() );\n\n$spreadsheet->getActiveSheet()->getCell('A1')->setValue(\"hello\\nworld\");\n```\n\nRead more about AdvancedValueBinder.php elsewhere.\n\n## Explicitly set a cell's datatype\n\nYou can set a cell's datatype explicitly by using the cell's\nsetValueExplicit method, or the setCellValueExplicit method of a\nworksheet. Here's an example:\n\n```php\n$spreadsheet->getActiveSheet()->getCell('A1')\n ->setValueExplicit(\n '25',\n \\PhpOffice\\PhpSpreadsheet\\Cell\\DataType::TYPE_NUMERIC\n );\n```\n\n## Change a cell into a clickable URL\n\nYou can make a cell (or, for Xlsx only, a drawing) a clickable URL by setting its hyperlink property:\n\n```php\n$spreadsheet->getActiveSheet()->setCellValue('E26', 'www.example.com');\n$spreadsheet->getActiveSheet()->getCell('E26')\n ->getHyperlink()\n ->setUrl('https://www.example.com');\n```\n\nIf you want to make a hyperlink to another worksheet/cell, use the\nfollowing code:\n\n```php\n$spreadsheet->getActiveSheet()\n ->setCellValue('E27', 'go to another sheet');\n$spreadsheet->getActiveSheet()->getCell('E27')\n ->getHyperlink()\n ->setUrl(\"sheet://'Sheetname'!A1\");\n```\nXlsx format uses `#` in place of `sheet://`.\nPhpSpreadsheet will automatically convert to that form when writing a spreadsheet,\nso you should continue to use `sheet://` for greater interoperability.\n\nExcel automatically supplies a special style when a hyperlink is\nentered into a cell. PhpSpreadsheet cannot do so. However,\nstarting with release 4.3,\nyou can mimic Excel's behavior with:\n```php\n$spreadsheet->getActiveSheet()\n ->getStyle('E26')\n ->getFont()\n ->setHyperlinkTheme();\n```\nThis will set underline (all formats) and text color (always\nfor Xlsx, and usually for other formats).\n\n## Setting Printer Options for Excel files\n\n### Setting a worksheet's page orientation and size\n\nSetting a worksheet's page orientation and size can be done using the\nfollowing lines of code:\n\n```php\n$spreadsheet->getActiveSheet()->getPageSetup()\n ->setOrientation(\\PhpOffice\\PhpSpreadsheet\\Worksheet\\PageSetup::ORIENTATION_LANDSCAPE);\n$spreadsheet->getActiveSheet()->getPageSetup()\n ->setPaperSize(\\PhpOffice\\PhpSpreadsheet\\Worksheet\\PageSetup::PAPERSIZE_A4);\n```\n\nNote that there are additional page settings available. Please refer to\nthe [API documentation](https://phpoffice.github.io/PhpSpreadsheet) for all possible options.\n\nThe default papersize is initially PAPERSIZE_LETTER. However, this default\ncan be changed for new sheets with the following call:\n```php\n\\PhpOffice\\PhpSpreadsheet\\Worksheet\\PageSetup::setPaperSizeDefault(\n \\PhpOffice\\PhpSpreadsheet\\Worksheet\\PageSetup::PAPERSIZE_A4\n);\n```\n\nThe default orientation is ORIENTATION_DEFAULT, which will be treated as Portrait in Excel. However, this default can be changed for new sheets with the following call:\n```php\n\\PhpOffice\\PhpSpreadsheet\\Worksheet\\PageSetup::setOrientationDefault(\n \\PhpOffice\\PhpSpreadsheet\\Worksheet\\PageSetup::ORIENTATION_LANDSCAPE\n);\n```\n\n### Page Setup: Scaling options\n\nThe page setup scaling options in PhpSpreadsheet relate directly to the\nscaling options in the \"Page Setup\" dialog as shown in the illustration.\n\nDefault values in PhpSpreadsheet correspond to default values in MS\nOffice Excel as shown in illustration\n\n\n\nmethod | initial value | calling method will trigger | Note\n--------------------|:-------------:|-----------------------------|------\nsetFitToPage(...) | FALSE | - |\nsetScale(...) | 100 | setFitToPage(FALSE) |\nsetFitToWidth(...) | 1 | setFitToPage(TRUE) | value 0 means do-not-fit-to-width\nsetFitToHeight(...) | 1 | setFitToPage(TRUE) | value 0 means do-not-fit-to-height\n\n#### Example\n\nHere is how to fit to 1 page wide by infinite pages tall:\n\n```php\n$spreadsheet->getActiveSheet()->getPageSetup()->setFitToWidth(1);\n$spreadsheet->getActiveSheet()->getPageSetup()->setFitToHeight(0);\n```\n\nAs you can see, it is not necessary to call setFitToPage(TRUE) since\nsetFitToWidth(...) and setFitToHeight(...) triggers this.\n\nIf you use `setFitToWidth()` you should in general also specify\n`setFitToHeight()` explicitly like in the example. Be careful relying on\nthe initial values.\n\n### Page margins\n\nTo set page margins for a worksheet, use this code:\n\n```php\n$spreadsheet->getActiveSheet()->getPageMargins()->setTop(1);\n$spreadsheet->getActiveSheet()->getPageMargins()->setRight(0.75);\n$spreadsheet->getActiveSheet()->getPageMargins()->setLeft(0.75);\n$spreadsheet->getActiveSheet()->getPageMargins()->setBottom(1);\n```\n\nNote that the margin values are specified in inches.\n\n\n\n### Center a page horizontally/vertically\n\nTo center a page horizontally/vertically, you can use the following\ncode:\n\n```php\n$spreadsheet->getActiveSheet()->getPageSetup()->setHorizontalCentered(true);\n$spreadsheet->getActiveSheet()->getPageSetup()->setVerticalCentered(false);\n```\n\n### Setting the print header and footer of a worksheet\n\nSetting a worksheet's print header and footer can be done using the\nfollowing lines of code:\n\n```php\n$spreadsheet->getActiveSheet()->getHeaderFooter()\n ->setOddHeader('&C&HPlease treat this document as confidential!');\n$spreadsheet->getActiveSheet()->getHeaderFooter()\n ->setOddFooter('&L&B' . $spreadsheet->getProperties()->getTitle() . '&RPage &P of &N');\n```\n\n\nNotice the use of `oddHeader/Footer` above. This is, by default, the header used on all pages, not just the odd-numbered pages. You can specify a different header/footer for the first page and/or for even-numbered pages.\n```php\n$spreadsheet->getActiveSheet()->getHeaderFooter()\n ->setDifferentFirst(true);\n// then as above except setFirstHeader/Footer rather than Odd\n$spreadsheet->getActiveSheet()->getHeaderFooter()\n ->setDifferentOddEven(true);\n// then as above except setEvenHeader/Footer rather than Odd\n```\n\nSubstitution and formatting codes (starting with &) can be used inside\nheaders and footers. There is no required order in which these codes\nmust appear.\n\nThe first occurrence of the following codes turns the formatting ON, the\nsecond occurrence turns it OFF again:\n\n- Strikethrough\n- Superscript\n- Subscript\n\nSuperscript and subscript cannot both be ON at same time. Whichever\ncomes first wins and the other is ignored, while the first is ON.\n\nThe following codes are supported by Xlsx:\n\nCode | Meaning\n-------------------------|-----------\n`&L` | Code for \"left section\" (there are three header / footer locations, \"left\", \"center\", and \"right\"). When two or more occurrences of this section marker exist, the contents from all markers are concatenated, in the order of appearance, and placed into the left section.\n`&P` | Code for \"current page #\"\n`&N` | Code for \"total pages\"\n`&font size` | Code for \"text font size\", where font size is a font size in points.\n`&K` | Code for \"text font color\" - RGB Color is specified as RRGGBB Theme Color is specifed as TTSNN where TT is the theme color Id, S is either \"+\" or \"-\" of the tint/shade value, NN is the tint/shade value.\n`&S` | Code for \"text strikethrough\" on / off\n`&X` | Code for \"text super script\" on / off\n`&Y` | Code for \"text subscript\" on / off\n`&C` | Code for \"center section\". When two or more occurrences of this section marker exist, the contents from all markers are concatenated, in the order of appearance, and placed into the center section.\n`&D` | Code for \"date\"\n`&T` | Code for \"time\"\n`&G` | Code for \"picture as background\" - Please make sure to add the image to the header/footer (see [Tip for picture](#Tip-for-picture))\n`&U` | Code for \"text single underline\"\n`&E` | Code for \"double underline\"\n`&R` | Code for \"right section\". When two or more occurrences of this section marker exist, the contents from all markers are concatenated, in the order of appearance, and placed into the right section.\n`&Z` | Code for \"this workbook's file path\"\n`&F` | Code for \"this workbook's file name\"\n`&A` | Code for \"sheet tab name\"\n`&+` | Code for add to page #\n`&-` | Code for subtract from page #\n`&\"font name,font type\"` | Code for \"text font name\" and \"text font type\", where font name and font type are strings specifying the name and type of the font, separated by a comma. When a hyphen appears in font name, it means \"none specified\". Both of font name and font type can be localized values.\n`&\"-,Bold\"` | Code for \"bold font style\"\n`&B` | Code for \"bold font style\"\n`&\"-,Regular\"` | Code for \"regular font style\"\n`&\"-,Italic\"` | Code for \"italic font style\"\n`&I` | Code for \"italic font style\"\n`&\"-,Bold Italic\"` | Code for \"bold italic font style\"\n`&O` | Code for \"outline style\"\n`&H` | Code for \"shadow style\"\n\n**Tip**\n\nThe above table of codes may seem overwhelming first time you are trying to\nfigure out how to write some header or footer. Luckily, there is an easier way.\nLet Microsoft Office Excel do the work for you.For example, create in Microsoft\n Office Excel an xlsx file where you insert the header and footer as desired\nusing the programs own interface. Save file as test.xlsx. Now, take that file\nand read off the values using PhpSpreadsheet as follows:\n\n```php\n$spreadsheet = \\PhpOffice\\PhpSpreadsheet\\IOFactory::load('test.xlsx');\n$worksheet = $spreadsheet->getActiveSheet();\n\nvar_dump($worksheet->getHeaderFooter()->getOddFooter());\nvar_dump($worksheet->getHeaderFooter()->getEvenFooter());\nvar_dump($worksheet->getHeaderFooter()->getOddHeader());\nvar_dump($worksheet->getHeaderFooter()->getEvenHeader());\n```\n\nThat reveals the codes for the even/odd header and footer. Experienced\nusers may find it easier to rename test.xlsx to test.zip, unzip it, and\ninspect directly the contents of the relevant xl/worksheets/sheetX.xml\nto find the codes for header/footer.\n\n\n**Tip for picture**\n\n```php\n$drawing = new \\PhpOffice\\PhpSpreadsheet\\Worksheet\\HeaderFooterDrawing();\n$drawing->setName('PhpSpreadsheet logo');\n$drawing->setPath('./images/PhpSpreadsheet_logo.png');\n$drawing->setHeight(36);\n$spreadsheet->getActiveSheet()\n ->getHeaderFooter()\n ->addImage(\n $drawing,\n \\PhpOffice\\PhpSpreadsheet\\Worksheet\\HeaderFooter::IMAGE_HEADER_LEFT\n );\n```\nIf you want your image to be used only on the first page or only on even pages, use, for example, `HeaderFooter::IMAGE_FOOTER_CENTER_EVEN`.\nYou must still call [`setDifferentFirst/Even`](#setDifferent) for this to work.\nThis will work only for Xlsx.\n\n### Setting printing breaks on a row or column\n\nTo set a print break, use the following code, which sets a row break on\nrow 10.\n\n```php\n$spreadsheet->getActiveSheet()->setBreak(\n 'A10',\n \\PhpOffice\\PhpSpreadsheet\\Worksheet\\Worksheet::BREAK_ROW\n);\n```\n\nThe following line of code sets a print break on column D:\n\n```php\n$spreadsheet->getActiveSheet()->setBreak(\n 'D10',\n \\PhpOffice\\PhpSpreadsheet\\Worksheet\\Worksheet::BREAK_COLUMN\n);\n```\n\n### Show/hide gridlines when printing\n\nTo show/hide gridlines when printing, use the following code:\n\n```php\n$spreadsheet->getActiveSheet()->setPrintGridlines(true);\n```\n\n### Setting rows/columns to repeat at top/left\n\nPhpSpreadsheet can repeat specific rows/cells at top/left of a page. The\nfollowing code is an example of how to repeat row 1 to 5 on each printed\npage of a specific worksheet:\n\n```php\n$spreadsheet->getActiveSheet()->getPageSetup()->setRowsToRepeatAtTopByStartAndEnd(1, 5);\n```\n\n### Specify printing area\n\nTo specify a worksheet's printing area, use the following code:\n\n```php\n$spreadsheet->getActiveSheet()->getPageSetup()->setPrintArea('A1:E5');\n```\n\nThere can also be multiple printing areas in a single worksheet:\n\n```php\n$spreadsheet->getActiveSheet()->getPageSetup()->setPrintArea('A1:E5,G4:M20');\n```\n\n## Styles\n\n### Formatting cells\n\nA cell can be formatted with font, border, fill, ... style information.\nFor example, one can set the foreground colour of a cell to red, aligned\nto the right, and the border to black and thick border style. Let's do\nthat on cell B2:\n\n```php\n$spreadsheet->getActiveSheet()->getStyle('B2')\n ->getFont()->getColor()->setARGB(\\PhpOffice\\PhpSpreadsheet\\Style\\Color::COLOR_RED);\n$spreadsheet->getActiveSheet()->getStyle('B2')\n ->getAlignment()->setHorizontal(\\PhpOffice\\PhpSpreadsheet\\Style\\Alignment::HORIZONTAL_RIGHT);\n$spreadsheet->getActiveSheet()->getStyle('B2')\n ->getBorders()->getTop()->setBorderStyle(\\PhpOffice\\PhpSpreadsheet\\Style\\Border::BORDER_THICK);\n$spreadsheet->getActiveSheet()->getStyle('B2')\n ->getBorders()->getBottom()->setBorderStyle(\\PhpOffice\\PhpSpreadsheet\\Style\\Border::BORDER_THICK);\n$spreadsheet->getActiveSheet()->getStyle('B2')\n ->getBorders()->getLeft()->setBorderStyle(\\PhpOffice\\PhpSpreadsheet\\Style\\Border::BORDER_THICK);\n$spreadsheet->getActiveSheet()->getStyle('B2')\n ->getBorders()->getRight()->setBorderStyle(\\PhpOffice\\PhpSpreadsheet\\Style\\Border::BORDER_THICK);\n$spreadsheet->getActiveSheet()->getStyle('B2')\n ->getFill()->setFillType(\\PhpOffice\\PhpSpreadsheet\\Style\\Fill::FILL_SOLID);\n$spreadsheet->getActiveSheet()->getStyle('B2')\n ->getFill()->getStartColor()->setARGB('FFFF0000');\n```\n\n`getStyle()` also accepts a cell range as a parameter. For example, you\ncan set a red background color on a range of cells:\n\n```php\n$spreadsheet->getActiveSheet()->getStyle('B3:B7')->getFill()\n ->setFillType(\\PhpOffice\\PhpSpreadsheet\\Style\\Fill::FILL_SOLID)\n ->getStartColor()->setARGB('FFFF0000');\n```\n\n**Tip** It is recommended to style many cells at once, using e.g.\ngetStyle('A1:M500'), rather than styling the cells individually in a\nloop. This is much faster compared to looping through cells and styling\nthem individually.\n\n**Tip** If you are styling entire row(s) or column(s), e.g. getStyle('A:A'), it is recommended to use applyFromArray as described below rather than setting the styles individually as described above.\nAlso, starting with release 3.9.0, you should use getRowStyle or getColumnStyle to get the style for an entire row or column.\n\nThere is also an alternative manner to set styles. The following code\nsets a cell's style to font bold, alignment right, top border thin and a\ngradient fill:\n\n```php\n$styleArray = [\n 'font' => [\n 'bold' => true,\n ],\n 'alignment' => [\n 'horizontal' => \\PhpOffice\\PhpSpreadsheet\\Style\\Alignment::HORIZONTAL_RIGHT,\n ],\n 'borders' => [\n 'top' => [\n 'borderStyle' => \\PhpOffice\\PhpSpreadsheet\\Style\\Border::BORDER_THIN,\n ],\n ],\n 'fill' => [\n 'fillType' => \\PhpOffice\\PhpSpreadsheet\\Style\\Fill::FILL_GRADIENT_LINEAR,\n 'rotation' => 90,\n 'startColor' => [\n 'argb' => 'FFA0A0A0',\n ],\n 'endColor' => [\n 'argb' => 'FFFFFFFF',\n ],\n ],\n];\n\n$spreadsheet->getActiveSheet()->getStyle('A3')->applyFromArray($styleArray);\n```\n\nOr with a range of cells:\n\n```php\n$spreadsheet->getActiveSheet()->getStyle('B3:B7')->applyFromArray($styleArray);\n```\n\nThis alternative method using arrays should be faster in terms of\nexecution whenever you are setting more than one style property. But the\ndifference may barely be measurable unless you have many different\nstyles in your workbook.\n\nYou can perform the opposite function, exporting a Style as an array,\nas follows:\n\n``` php\n$styleArray = $spreadsheet->getActiveSheet()->getStyle('A3')->exportArray();\n```\n\n### Number formats\n\nYou often want to format numbers in Excel. For example you may want a\nthousands separator plus a fixed number of decimals after the decimal\nseparator. Or perhaps you want some numbers to be zero-padded.\n\nIn Microsoft Office Excel you may be familiar with selecting a number\nformat from the \"Format Cells\" dialog. Here there are some predefined\nnumber formats available including some for dates. The dialog is\ndesigned in a way so you don't have to interact with the underlying raw\nnumber format code unless you need a custom number format.\n\nIn PhpSpreadsheet, you can also apply various predefined number formats.\nExample:\n\n```php\n$spreadsheet->getActiveSheet()->getStyle('A1')->getNumberFormat()\n ->setFormatCode(\\PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat::FORMAT_NUMBER_COMMA_SEPARATED1);\n```\n\nThis will format a number e.g. 1587.2 so it shows up as 1,587.20 when\nyou open the workbook in MS Office Excel. (Depending on settings for\ndecimal and thousands separators in Microsoft Office Excel it may show\nup as 1.587,20)\n\nYou can achieve exactly the same as the above by using this:\n\n```php\n$spreadsheet->getActiveSheet()->getStyle('A1')->getNumberFormat()\n ->setFormatCode('#,##0.00');\n```\n\nIn Microsoft Office Excel, as well as in PhpSpreadsheet, you will have\nto interact with raw number format codes whenever you need some special\ncustom number format. Example:\n\n```php\n$spreadsheet->getActiveSheet()->getStyle('A1')->getNumberFormat()\n ->setFormatCode('[Blue][>=3000]$#,##0;[Red][<0]$#,##0;$#,##0');\n```\n\nAnother example is when you want numbers zero-padded with leading zeros\nto a fixed length:\n\n```php\n$spreadsheet->getActiveSheet()->getCell('A1')->setValue(19);\n$spreadsheet->getActiveSheet()->getStyle('A1')->getNumberFormat()\n ->setFormatCode('0000'); // will show as 0019 in Excel\n```\n\n**Tip** The rules for composing a number format code in Excel can be\nrather complicated. Sometimes you know how to create some number format\nin Microsoft Office Excel, but don't know what the underlying number\nformat code looks like. How do you find it?\n\nThe readers shipped with PhpSpreadsheet come to the rescue. Load your\ntemplate workbook using e.g. Xlsx reader to reveal the number format\ncode. Example how read a number format code for cell A1:\n\n```php\n$reader = \\PhpOffice\\PhpSpreadsheet\\IOFactory::createReader('Xlsx');\n$spreadsheet = $reader->load('template.xlsx');\nvar_dump($spreadsheet->getActiveSheet()->getStyle('A1')->getNumberFormat()->getFormatCode());\n```\n\nAdvanced users may find it faster to inspect the number format code\ndirectly by renaming template.xlsx to template.zip, unzipping, and\nlooking for the relevant piece of XML code holding the number format\ncode in *xl/styles.xml*.\n\n### Alignment and wrap text\n\nLet's set vertical alignment to the top for cells A1:D4\n\n```php\n$spreadsheet->getActiveSheet()->getStyle('A1:D4')\n ->getAlignment()->setVertical(\\PhpOffice\\PhpSpreadsheet\\Style\\Alignment::VERTICAL_TOP);\n```\n\nHere is how to achieve wrap text:\n\n```php\n$spreadsheet->getActiveSheet()->getStyle('A1:D4')\n ->getAlignment()->setWrapText(true);\n```\n\n### Setting the default style of a workbook\n\nIt is possible to set the default style of a workbook. Let's set the\ndefault font to Arial size 8:\n\n```php\n$spreadsheet->getDefaultStyle()->getFont()->setName('Arial');\n$spreadsheet->getDefaultStyle()->getFont()->setSize(8);\n```\n\nExcel also offers \"theme fonts\", with separate font names for major (header) and minor (body) text. PhpSpreadsheet will use the Excel 2007 default (Cambria) for major (default is Calibri Light in Excel 2013+); PhpSpreadsheet default for minor is Calibri, which is used by Excel 2007+. To align the default font name with the minor font name:\n\n```php\n$spreadsheet->getTheme()\n ->setThemeFontName('custom')\n ->setMinorFontValues('Arial', 'Arial', 'Arial', []);\n$spreadsheet->getDefaultStyle()->getFont()->setScheme('minor');\n```\n\nAll cells bound to the theme fonts (via the `Font::setScheme` method) can be easily changed to a different font in Excel. To do this in PhpSpreadsheet, an additional method call is needed:\n```php\n$spreadsheet->resetThemeFonts();\n```\n\n### Charset for Arabic and Persian Fonts\n\nIt is unknown why this should be needed. However, some Excel\nusers have reported better results if the internal declaration for an\nArabic/Persian font includes a `charset` declaration.\nThis seems like a bug in Excel, but, starting with release 4.4,\nthis can be accomplished at the spreadsheet level, via:\n```php\n$spreadsheet->addFontCharset('C Nazanin');\n```\nAs many charsets as desired can be added in this manner.\nThere is a second optional parameter specifying the charset id\nto this method, but, since this seems to be needed only for\nArabic/Persian, that is its default value.\n\n### Styling cell borders\n\nIn PhpSpreadsheet it is easy to apply various borders on a rectangular\nselection. Here is how to apply a thick red border outline around cells\nB2:G8.\n\n```php\n$styleArray = [\n 'borders' => [\n 'outline' => [\n 'borderStyle' => \\PhpOffice\\PhpSpreadsheet\\Style\\Border::BORDER_THICK,\n 'color' => ['argb' => 'FFFF0000'],\n ],\n ],\n];\n\n$worksheet->getStyle('B2:G8')->applyFromArray($styleArray);\n```\n\nIn Microsoft Office Excel, the above operation would correspond to\nselecting the cells B2:G8, launching the style dialog, choosing a thick\nred border, and clicking on the \"Outline\" border component.\n\nNote that the border outline is applied to the rectangular selection\nB2:G8 as a whole, not on each cell individually.\n\nYou can achieve any border effect by using just the 5 basic borders and\noperating on a single cell at a time:\n\n- left\n- right\n- top\n- bottom\n- diagonal\n\nAdditional shortcut borders come in handy like in the example above.\nThese are the shortcut borders available:\n\n- allBorders\n- outline\n- inside\n- vertical\n- horizontal\n\nAn overview of all border shortcuts can be seen in the following image:\n\n\n\nIf you simultaneously set e.g. allBorders and vertical, then we have\n\"overlapping\" borders, and one of the components has to win over the\nother where there is border overlap. In PhpSpreadsheet, from weakest to\nstrongest borders, the list is as follows: allBorders, outline/inside,\nvertical/horizontal, left/right/top/bottom/diagonal.\n\nThis border hierarchy can be utilized to achieve various effects in an\neasy manner.\n\n#### Advanced borders\n\nThere is a second parameter `$advancedBorders` which can be supplied to applyFromArray. The default is `true`; when set to this value, the border styles are applied to the range as a whole, not to the individual cells. When set to `false`, the border styles are applied to each cell. The following code and screenshot demonstrates the difference.\n\n```php\n$sheet->setShowGridlines(false);\n$styleArray = [\n 'borders' => [\n 'bottom' => ['borderStyle' => 'hair', 'color' => ['argb' => 'FFFF0000']],\n 'top' => ['borderStyle' => 'hair', 'color' => ['argb' => 'FFFF0000']],\n 'right' => ['borderStyle' => 'hair', 'color' => ['argb' => 'FF00FF00']],\n 'left' => ['borderStyle' => 'hair', 'color' => ['argb' => 'FF00FF00']],\n ],\n];\n$sheet->getStyle('B2:C3')->applyFromArray($styleArray);\n$sheet->getStyle('B5:C6')->applyFromArray($styleArray, false);\n```\n\n\n\n### Valid array keys for style `applyFromArray()`\n\nThe following table lists the valid array keys for\n`\\PhpOffice\\PhpSpreadsheet\\Style\\Style::applyFromArray()` classes. If the \"Maps\nto property\" column maps a key to a setter, the value provided for that\nkey will be applied directly. If the \"Maps to property\" column maps a\nkey to a getter, the value provided for that key will be applied as\nanother style array.\n\n**\\PhpOffice\\PhpSpreadsheet\\Style\\Style**\n\nArray key | Maps to property\n-------------|-------------------\nalignment | setAlignment()\nborders | setBorders()\nfill | setFill()\nfont | setFont()\nnumberFormat | setNumberFormat()\nprotection | setProtection()\nquotePrefix | setQuotePrefix()\n\n**\\PhpOffice\\PhpSpreadsheet\\Style\\Alignment**\n\nArray key | Maps to property\n----------------|-------------------\nhorizontal | setHorizontal()\njustifyLastLine | setJustifyLastLine()\nindent | setIndent()\nreadOrder | setReadOrder()\nshrinkToFit | setShrinkToFit()\ntextRotation | setTextRotation()\nvertical | setVertical()\nwrapText | setWrapText()\n\n**\\PhpOffice\\PhpSpreadsheet\\Style\\Border**\n\nArray key | Maps to property\n------------|-------------------\nborderStyle | setBorderStyle()\ncolor | setColor()\n\n**\\PhpOffice\\PhpSpreadsheet\\Style\\Borders**\n\nArray key | Maps to property\n------------------|-------------------\nallBorders | getLeft(); getRight(); getTop(); getBottom()\nbottom | getBottom()\ndiagonal | getDiagonal()\ndiagonalDirection | setDiagonalDirection()\nleft | getLeft()\nright | getRight()\ntop | getTop()\n\n**\\PhpOffice\\PhpSpreadsheet\\Style\\Color**\n\nArray key | Maps to property\n------------|-------------------\nargb | setARGB()\n\n**\\PhpOffice\\PhpSpreadsheet\\Style\\Fill**\n\nArray key | Maps to property\n-----------|-------------------\ncolor | getStartColor()\nendColor | getEndColor()\nfillType | setFillType()\nrotation | setRotation()\nstartColor | getStartColor()\n\n**\\PhpOffice\\PhpSpreadsheet\\Style\\Font**\n\nArray key | Maps to property\n------------|-------------------\nbold | setBold()\ncolor | getColor()\nitalic | setItalic()\nname | setName()\nsize | setSize()\nstrikethrough | setStrikethrough()\nsubscript | setSubscript()\nsuperscript | setSuperscript()\nunderline | setUnderline()\n\n**\\PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat**\n\nArray key | Maps to property\n----------|-------------------\nformatCode | setFormatCode()\n\n**\\PhpOffice\\PhpSpreadsheet\\Style\\Protection**\n\nArray key | Maps to property\n----------|-------------------\nlocked | setLocked()\nhidden | setHidden()\n\n## Conditional formatting a cell\n\nA cell can be formatted conditionally, based on a specific rule. For\nexample, one can set the foreground colour of a cell to red if its value\nis below zero, and to green if its value is zero or more.\n\nOne can set a conditional style ruleset to a cell using the following\ncode:\n\n```php\n$conditional1 = new \\PhpOffice\\PhpSpreadsheet\\Style\\Conditional();\n$conditional1->setConditionType(\\PhpOffice\\PhpSpreadsheet\\Style\\Conditional::CONDITION_CELLIS);\n$conditional1->setOperatorType(\\PhpOffice\\PhpSpreadsheet\\Style\\Conditional::OPERATOR_LESSTHAN);\n$conditional1->addCondition('0');\n$conditional1->getStyle()->getFont()->getColor()->setARGB(\\PhpOffice\\PhpSpreadsheet\\Style\\Color::COLOR_RED);\n$conditional1->getStyle()->getFont()->setBold(true);\n\n$conditional2 = new \\PhpOffice\\PhpSpreadsheet\\Style\\Conditional();\n$conditional2->setConditionType(\\PhpOffice\\PhpSpreadsheet\\Style\\Conditional::CONDITION_CELLIS);\n$conditional2->setOperatorType(\\PhpOffice\\PhpSpreadsheet\\Style\\Conditional::OPERATOR_GREATERTHANOREQUAL);\n$conditional2->addCondition('0');\n$conditional2->getStyle()->getFont()->getColor()->setARGB(\\PhpOffice\\PhpSpreadsheet\\Style\\Color::COLOR_GREEN);\n$conditional2->getStyle()->getFont()->setBold(true);\n\n$conditionalStyles = $spreadsheet->getActiveSheet()->getStyle('B2')->getConditionalStyles();\n$conditionalStyles[] = $conditional1;\n$conditionalStyles[] = $conditional2;\n\n$spreadsheet->getActiveSheet()->getStyle('B2')->setConditionalStyles($conditionalStyles);\n```\n\nIf you want to copy the ruleset to other cells, you can duplicate the\nstyle object:\n\n```php\n$spreadsheet->getActiveSheet()\n ->duplicateConditionalStyle(\n $spreadsheet->getActiveSheet()->getConditionalStyles('B2'),\n 'B3:B7'\n );\n```\n\nMore detailed documentation of the Conditional Formatting options and rules, and the use of Wizards to help create them, can be found in [a dedicated section of the documentation](https://phpspreadsheet.readthedocs.io/en/latest/topics/conditional-formatting/).\n\n### DataBar of Conditional formatting\nThe basics are the same as conditional formatting.\nAdditional DataBar object to conditional formatting.\n\nFor example, the following code will result in the conditional formatting shown in the image.\n```php\n$conditional = new Conditional();\n$conditional->setConditionType(Conditional::CONDITION_DATABAR);\n$conditional->setDataBar(new ConditionalDataBar());\n$conditional->getDataBar()\n ->setMinimumConditionalFormatValueObject(new ConditionalFormatValueObject('num', '2'))\n ->setMaximumConditionalFormatValueObject(new ConditionalFormatValueObject('max'))\n ->setColor('FFFF555A');\n$ext = $conditional\n ->getDataBar()\n ->setConditionalFormattingRuleExt(new ConditionalFormattingRuleExtension())\n ->getConditionalFormattingRuleExt();\n \n$ext->setCfRule('dataBar');\n$ext->setSqref('A1:A5'); // target CellCoordinates\n$ext->setDataBarExt(new ConditionalDataBarExtension());\n$ext->getDataBarExt()\n ->setMinimumConditionalFormatValueObject(new ConditionalFormatValueObject('num', '2'))\n ->setMaximumConditionalFormatValueObject(new ConditionalFormatValueObject('autoMax'))\n ->setMinLength(0)\n ->setMaxLength(100)\n ->setBorder(true)\n ->setDirection('rightToLeft')\n ->setNegativeBarBorderColorSameAsPositive(false)\n ->setBorderColor('FFFF555A')\n ->setNegativeFillColor('FFFF0000')\n ->setNegativeBorderColor('FFFF0000')\n ->setAxisColor('FF000000');\n\n```\n\n\n\n## Add a comment to a cell\n\nTo add a comment to a cell, use the following code. The example below\nadds a comment to cell E11:\n\n```php\n$spreadsheet->getActiveSheet()\n ->getComment('E11')\n ->setAuthor('Mark Baker');\n$commentRichText = $spreadsheet->getActiveSheet()\n ->getComment('E11')\n ->getText()->createTextRun('PhpSpreadsheet:');\n$commentRichText->getFont()->setBold(true);\n$spreadsheet->getActiveSheet()\n ->getComment('E11')\n ->getText()->createTextRun(\"\\r\\n\");\n$spreadsheet->getActiveSheet()\n ->getComment('E11')\n ->getText()->createTextRun('Total amount on the current invoice, excluding VAT.');\n```\n\n\n## Add a comment with background image to a cell\n\nTo add a comment with background image to a cell, use the following code:\n\n```php\n$sheet = $spreadsheet->getActiveSheet();\n$sheet->setCellValue('B5', 'Gibli Chromo');\n// Add png image to comment background\n$drawing = new Drawing();\n$drawing->setName('Gibli Chromo');\n$drawing->setPath('/tmp/gibli_chromo.png');\n$comment = $sheet->getComment('B5');\n$comment->setBackgroundImage($drawing);\n// Set the size of the comment equal to the size of the image \n$comment->setSizeAsBackgroundImage();\n```\n\n\n## Apply autofilter to a range of cells\n\nTo apply an autofilter to a range of cells, use the following code:\n\n```php\n$spreadsheet->getActiveSheet()->setAutoFilter('A1:C9');\n```\n\n**Make sure that you always include the complete filter range!** Excel\ndoes support setting only the caption row, but that's **not** a best\npractice...\n\n## Setting security on a spreadsheet\n\nExcel offers 3 levels of \"protection\":\n\n- Document: allows you to set a password on a complete\nspreadsheet, allowing changes to be made only when that password is\nentered.\n- Worksheet: offers other security options: you can\ndisallow inserting rows on a specific sheet, disallow sorting, ...\n- Cell: offers the option to lock/unlock a cell as well as show/hide\nthe internal formula.\n\n**Make sure you enable worksheet protection if you need any of the\nworksheet or cell protection features!** This can be done using the following\ncode:\n\n```php\n$spreadsheet->getActiveSheet()->getProtection()->setSheet(true);\n```\n\n> Note that \"protection\" is not the same as \"encryption\".\n> Protection is about preventing parts of a spreadsheet from being changed, not about preventing the spreadsheet from being looked at.
\nPhpSpreadsheet does not support encrypting a spreadsheet; nor can it read encrypted spreadsheets.\n\n### Document\n\nAn example on setting document security:\n\n```php\n$security = $spreadsheet->getSecurity();\n$security->setLockWindows(true);\n$security->setLockStructure(true);\n$security->setWorkbookPassword(\"PhpSpreadsheet\");\n```\n\nNote that there are additional methods setLockRevision and setRevisionsPassword\nwhich apply only to change tracking and history for shared workbooks.\n\n### Worksheet\n\nAn example on setting worksheet security\n(user can sort, insert rows, or format cells without unprotecting):\n\n```php\n$protection = $spreadsheet->getActiveSheet()->getProtection();\n$protection->setPassword('PhpSpreadsheet');\n$protection->setSheet(true);\n$protection->setSort(false);\n$protection->setInsertRows(false);\n$protection->setFormatCells(false);\n```\n\nNote that allowing sort without providing the sheet password\n(similarly with autoFilter) requires that you explicitly\nenable the cell ranges for which sort is permitted,\nwith or without a range password:\n```php\n$sheet->protectCells('A:A'); // column A can be sorted without password\n$sheet->protectCells('B:B', 'sortpw'); // column B can be sorted if the range password sortpw is supplied\n```\n\nIf writing Xlsx files you can specify the algorithm used to hash the password\nbefore calling `setPassword()` like so:\n\n```php\n$protection = $spreadsheet->getActiveSheet()->getProtection();\n$protection->setAlgorithm(Protection::ALGORITHM_SHA_512);\n$protection->setSpinCount(20000);\n$protection->setPassword('PhpSpreadsheet');\n```\n\nThe salt should **not** be set manually and will be automatically generated\nwhen setting a new password.\n\n### Cell\n\nAn example on setting cell security.\nNote that cell security is honored only when sheet is protected.\nAlso note that the `hidden` property applies only to formulas,\nand tells whether the formula is hidden on the formula bar,\nnot in the cell.\n\n```php\n$spreadsheet->getActiveSheet()->getStyle('B1')\n ->getProtection()\n ->setLocked(\\PhpOffice\\PhpSpreadsheet\\Style\\Protection::PROTECTION_UNPROTECTED)\n ->setHidden(\\PhpOffice\\PhpSpreadsheet\\Style\\Protection::PROTECTION_PROTECTED);\n```\n\n## Reading protected spreadsheet\n\nSpreadsheets that are protected as described above can always be read by\nPhpSpreadsheet. There is no need to know the password or do anything special in\norder to read a protected file.\n\nHowever if you need to implement a password verification mechanism, you can use the\nfollowing helper method:\n\n\n```php\n$protection = $spreadsheet->getActiveSheet()->getProtection();\n$allowed = $protection->verify('my password');\n\nif ($allowed) {\n doSomething();\n} else {\n throw new Exception('Incorrect password');\n}\n```\n\nIf you need to completely prevent reading a file by any tool, including PhpSpreadsheet,\nthen you are looking for \"encryption\", not \"protection\".\n\n## Setting data validation on a cell\n\nData validation is a powerful feature of Xlsx. It allows to specify an\ninput filter on the data that can be inserted in a specific cell. This\nfilter can be a range (i.e. value must be between 0 and 10), a list\n(i.e. value must be picked from a list), ...\n\nThe following piece of code only allows numbers between 10 and 20 to be\nentered in cell B3:\n\n```php\n$validation = $spreadsheet->getActiveSheet()->getCell('B3')\n ->getDataValidation();\n$validation->setType( \\PhpOffice\\PhpSpreadsheet\\Cell\\DataValidation::TYPE_WHOLE );\n$validation->setErrorStyle( \\PhpOffice\\PhpSpreadsheet\\Cell\\DataValidation::STYLE_STOP );\n$validation->setAllowBlank(true);\n$validation->setShowInputMessage(true);\n$validation->setShowErrorMessage(true);\n$validation->setErrorTitle('Input error');\n$validation->setError('Number is not allowed!');\n$validation->setPromptTitle('Allowed input');\n$validation->setPrompt('Only numbers between 10 and 20 are allowed.');\n$validation->setFormula1(10);\n$validation->setFormula2(20);\n```\n\nThe following piece of code only allows an item picked from a list of\ndata to be entered in cell B5:\n\n```php\n$validation = $spreadsheet->getActiveSheet()->getCell('B5')\n ->getDataValidation();\n$validation->setType( \\PhpOffice\\PhpSpreadsheet\\Cell\\DataValidation::TYPE_LIST );\n$validation->setErrorStyle( \\PhpOffice\\PhpSpreadsheet\\Cell\\DataValidation::STYLE_INFORMATION );\n$validation->setAllowBlank(false);\n$validation->setShowInputMessage(true);\n$validation->setShowErrorMessage(true);\n$validation->setShowDropDown(true);\n$validation->setErrorTitle('Input error');\n$validation->setError('Value is not in list.');\n$validation->setPromptTitle('Pick from list');\n$validation->setPrompt('Please pick a value from the drop-down list.');\n$validation->setFormula1('\"Item A,Item B,Item C\"');\n```\n\nWhen using a data validation list like above, make sure you put the list\nbetween `\"` and `\"` and that you split the items with a comma (`,`).\n\nIt is important to remember that any string participating in an Excel\nformula is allowed to be maximum 255 characters (not bytes). This sets a\nlimit on how many items you can have in the string \"Item A,Item B,Item\nC\". Therefore it is normally a better idea to type the item values\ndirectly in some cell range, say A1:A3, and instead use, say,\n`$validation->setFormula1('\\'Sheet title\\'!$A$1:$A$3')`. Another benefit is that\nthe item values themselves can contain the comma `,` character itself.\n\n### Setting Validation on Multiple Cells - Release 3 and Below\n\nIf you need data validation on multiple cells, one can clone the\nruleset:\n\n```php\n$spreadsheet->getActiveSheet()->getCell('B8')->setDataValidation(clone $validation);\n```\n\nAlternatively, one can apply the validation to a range of cells:\n```php\n$validation->setSqref('B5:B1048576');\n```\n\n### Setting Validation on Multiple Cells - Release 4 and Above\n\nStarting with Release 4, Data Validation can be set simultaneously on several cells/cell ranges.\n\n```php\n$spreadsheet->getActiveSheet()->getDataValidation('A1:A4 D5 E6:E7')\n ->set...(...);\n```\n\nIn theory, this means that more than one Data Validation can apply to a cell.\nIt appears that, when Excel reads a spreadsheet with more than one Data Validation applying to a cell,\nwhichever appears first in the Xml is what Xml uses.\nPhpSpreadsheet will instead apply a DatValidation applying to a single cell first;\nthen, if it doesn't find such a match, it will use the first applicable definition which is read (or created after or in lieu of reading).\nThis allows you, for example, to set Data Validation on all but a few cells in a column:\n```php\n$dv = new DataValidation();\n$dv->setType(DataValidation::TYPE_NONE);\n$sheet->setDataValidation('A5:A7', $dv);\n$dv = new DataValidation();\n$dv->set...(...);\n$sheet->setDataValidation('A:A', $dv);\n$dv = new DataValidation();\n$dv->setType(DataValidation::TYPE_NONE);\n$sheet->setDataValidation('A9', $dv);\n```\n\n## Setting a column's width\n\nA column's width can be set using the following code:\n\n```php\n$spreadsheet->getActiveSheet()->getColumnDimension('D')->setWidth(12);\n```\n\nIf you want to set a column width using a different UoM (Unit of Measure),\nthen you can do so by telling PhpSpreadsheet what UoM the width value\nthat you are setting is measured in.\nValid units are `pt` (points), `px` (pixels), `pc` (pica), `in` (inches),\n`cm` (centimeters) and `mm` (millimeters).\n\nSetting the column width to `-1` tells MS Excel to display the column using its default width. \n\n```php\n$spreadsheet->getActiveSheet()->getColumnDimension('D')->setWidth(120, 'pt');\n```\n\nIf you want PhpSpreadsheet to perform an automatic width calculation,\nuse the following code. PhpSpreadsheet will approximate the column width\nto the width of the widest value displayed in that column.\n\n```php\n$spreadsheet->getActiveSheet()->getColumnDimension('B')->setAutoSize(true);\n```\n\n\n\nThe measure for column width in PhpSpreadsheet does **not** correspond\nexactly to the measure you may be used to in Microsoft Office Excel.\nColumn widths are difficult to deal with in Excel, and there are several\nmeasures for the column width.\n\n1. Inner width in character units\n(e.g. 8.43 this is probably what you are familiar with in Excel)\n2. Full width in pixels (e.g. 64 pixels)\n3. Full width in character units (e.g. 9.140625, value -1 indicates unset width)\n\n**PhpSpreadsheet always\noperates with \"3. Full width in character units\"** which is in fact the\nonly value that is stored in any Excel file, hence the most reliable\nmeasure. Unfortunately, **Microsoft Office Excel does not present you\nwith this measure**. Instead measures 1 and 2 are computed by the\napplication when the file is opened and these values are presented in\nvarious dialogues and tool tips.\n\nThe character width unit is the width of\na `0` (zero) glyph in the workbooks default font. Therefore column\nwidths measured in character units in two different workbooks can only\nbe compared if they have the same default workbook font.If you have some\nExcel file and need to know the column widths in measure 3, you can\nread the Excel file with PhpSpreadsheet and echo the retrieved values.\n\n## Show/hide a column\n\nTo set a worksheet's column visibility, you can use the following code.\nThe first line explicitly shows the column C, the second line hides\ncolumn D.\n\n```php\n$spreadsheet->getActiveSheet()->getColumnDimension('C')->setVisible(true);\n$spreadsheet->getActiveSheet()->getColumnDimension('D')->setVisible(false);\n```\n\n## Group/outline a column\n\nTo group/outline a column, you can use the following code:\n\n```php\n$spreadsheet->getActiveSheet()->getColumnDimension('E')->setOutlineLevel(1);\n```\n\nYou can also collapse the column. Note that you should also set the\ncolumn invisible, otherwise the collapse will not be visible in Excel\n2007.\n\n```php\n$spreadsheet->getActiveSheet()->getColumnDimension('E')->setCollapsed(true);\n$spreadsheet->getActiveSheet()->getColumnDimension('E')->setVisible(false);\n```\n\nPlease refer to the section \"group/outline a row\" for a complete example\non collapsing.\n\nYou can instruct PhpSpreadsheet to add a summary to the right (default),\nor to the left. The following code adds the summary to the left:\n\n```php\n$spreadsheet->getActiveSheet()->setShowSummaryRight(false);\n```\n\n## Setting a row's height\n\nA row's height can be set using the following code:\n\n```php\n$spreadsheet->getActiveSheet()->getRowDimension('10')->setRowHeight(100);\n```\n\nExcel measures row height in points, where 1 pt is 1/72 of an inch (or\nabout 0.35mm). The default value is 12.75 pts; and the permitted range\nof values is between 0 and 409 pts, where 0 pts is a hidden row.\n\nIf you want to set a row height using a different UoM (Unit of Measure),\nthen you can do so by telling PhpSpreadsheet what UoM the height value\nthat you are setting is measured in.\nValid units are `pt` (points), `px` (pixels), `pc` (pica), `in` (inches),\n`cm` (centimeters) and `mm` (millimeters).\n\n```php\n$spreadsheet->getActiveSheet()->getRowDimension('10')->setRowHeight(100, 'pt');\n```\n\nSetting the row height to `-1` tells MS Excel to display the column using its default height, which is based on the character font size.\n\nIf you have wrapped text in a cell, then the `-1` default will only set the row height to display a single line of that wrapped text.\nIf you need to calculate the actual height for the row, then count the lines that should be displayed (count the `\\n` and add 1); then adjust for the font.\nThe adjustment for Calibri 11 is approximately 14.5; for Calibri 12 15.9, etc.\n```php\n$spreadsheet->getActiveSheet()->getRowDimension(1)->setRowHeight(\n 14.5 * (substr_count($sheet->getCell('A1')->getValue(), \"\\n\") + 1)\n);\n```\n\n\n## Show/hide a row\n\nTo set a worksheet''s row visibility, you can use the following code.\nThe following example hides row number 10.\n\n```php\n$spreadsheet->getActiveSheet()->getRowDimension('10')->setVisible(false);\n```\n\nNote that if you apply active filters using an AutoFilter, then this\nwill override any rows that you hide or unhide manually within that\nAutoFilter range if you save the file.\n\n## Group/outline a row\n\nTo group/outline a row, you can use the following code:\n\n```php\n$spreadsheet->getActiveSheet()->getRowDimension('5')->setOutlineLevel(1);\n```\n\nYou can also collapse the row. Note that you should also set the row\ninvisible, otherwise the collapse will not be visible in Excel 2007.\n\n```php\n$spreadsheet->getActiveSheet()->getRowDimension('5')->setCollapsed(true);\n$spreadsheet->getActiveSheet()->getRowDimension('5')->setVisible(false);\n```\n\nHere's an example which collapses rows 50 to 80:\n\n```php\nfor ($i = 51; $i <= 80; $i++) {\n $spreadsheet->getActiveSheet()->setCellValue('A' . $i, \"FName $i\");\n $spreadsheet->getActiveSheet()->setCellValue('B' . $i, \"LName $i\");\n $spreadsheet->getActiveSheet()->setCellValue('C' . $i, \"PhoneNo $i\");\n $spreadsheet->getActiveSheet()->setCellValue('D' . $i, \"FaxNo $i\");\n $spreadsheet->getActiveSheet()->setCellValue('E' . $i, true);\n $spreadsheet->getActiveSheet()->getRowDimension($i)->setOutlineLevel(1);\n $spreadsheet->getActiveSheet()->getRowDimension($i)->setVisible(false);\n}\n\n$spreadsheet->getActiveSheet()->getRowDimension(81)->setCollapsed(true);\n```\n\nYou can instruct PhpSpreadsheet to add a summary below the collapsible\nrows (default), or above. The following code adds the summary above:\n\n```php\n$spreadsheet->getActiveSheet()->setShowSummaryBelow(false);\n```\n\n## Merge/Unmerge cells\n\nIf you have a big piece of data you want to display in a worksheet, or a\nheading that needs to span multiple sub-heading columns, you can merge\ntwo or more cells together, to become one cell. This can be done using\nthe following code:\n\n```php\n$spreadsheet->getActiveSheet()->mergeCells('A18:E22');\n```\n\nRemoving a merge can be done using the `unmergeCells()` method:\n\n```php\n$spreadsheet->getActiveSheet()->unmergeCells('A18:E22');\n```\n\nMS Excel itself doesn't yet offer the functionality to simply hide the merged cells, or to merge the content of cells into a single cell, but it is available in Open/Libre Office.\n\n### Merge with MERGE_CELL_CONTENT_EMPTY\n\nThe default behaviour is to empty all cells except for the top-left corner cell in the merge range; and this is also the default behaviour for the `mergeCells()` method in PhpSpreadsheet.\nWhen this behaviour is applied, those cell values will be set to null; and if they are subsequently Unmerged, they will be empty cells.\n\nPassing an extra flag value to the `mergeCells()` method in PhpSpreadsheet can change this behaviour.\n\n\n\nPossible flag values are:\n- Worksheet::MERGE_CELL_CONTENT_EMPTY (the default)\n- Worksheet::MERGE_CELL_CONTENT_HIDE\n- Worksheet::MERGE_CELL_CONTENT_MERGE\n\n### Merge with MERGE_CELL_CONTENT_HIDE\n\nThe first alternative, available only in OpenOffice, is to hide those cells, but to leave their content intact.\nWhen a file saved as `Xlsx` in those applications is opened in MS Excel, and those cells are unmerged, the original content will still be present.\n\n```php\n$spreadsheet->getActiveSheet()->mergeCells('A1:C3', Worksheet::MERGE_CELL_CONTENT_HIDE);\n```\n\nWill replicate that behaviour.\n\n### Merge with MERGE_CELL_CONTENT_MERGE\n\nThe second alternative, available in both OpenOffice and LibreOffice is to merge the content of every cell in the merge range into the top-left cell, while setting those hidden cells to empty.\n\n```php\n$spreadsheet->getActiveSheet()->mergeCells('A1:C3', Worksheet::MERGE_CELL_CONTENT_MERGE);\n```\n\nParticularly when the merged cells contain formulas, the logic for this merge seems strange:\nwalking through the merge range, each cell is calculated in turn, and appended to the \"master\" cell, then it is emptied, so any subsequent calculations that reference the cell see an empty cell, not the pre-merge value. \nFor example, suppose our spreadsheet contains\n\n\n\nwhere `B2` is the formula `=5-B1` and `C2` is the formula `=A2/B2`,\nand we want to merge cells `A2` to `C2` with all the cell values merged.\nThe result is:\n\n\n\nThe cell value `12` from cell `A2` is fixed; the value from `B2` is the result of the formula `=5-B1` (`4`, which is appended to our merged value), and cell `B2` is then emptied, so when we evaluate cell `C2` with the formula `=A2/B2` it gives us `12 / 0` which results in a `#DIV/0!` error (so the error `#DIV/0!` is appended to our merged value rather than the original calculation result of `3`).\n\n## Inserting or Removing rows/columns\n\nYou can insert/remove rows/columns at a specific position. The following\ncode inserts 2 new rows, right before row 7:\n\n```php\n$spreadsheet->getActiveSheet()->insertNewRowBefore(7, 2);\n```\nwhile\n```php\n$spreadsheet->getActiveSheet()->removeRow(7, 2);\n```\nwill remove 2 rows starting at row number 7 (ie. rows 7 and 8).\n\nEquivalent methods exist for inserting/removing columns:\n\n```php\n$spreadsheet->getActiveSheet()->removeColumn('C', 2);\n```\n\nAll subsequent rows (or columns) will be moved to allow the insertion (or removal) with all formulas referencing thise cells adjusted accordingly.\n\nNote that this is a fairly intensive process, particularly with large worksheets, and especially if you are inserting/removing rows/columns from near beginning of the worksheet.\n\nIf you need to insert/remove several consecutive rows/columns, always use the second argument rather than making multiple calls to insert/remove a single row/column if possible.\n\n## Add a drawing to a worksheet\n\nA drawing is always represented as a separate object, which can be added\nto a worksheet. Therefore, you must first instantiate a new\n`\\PhpOffice\\PhpSpreadsheet\\Worksheet\\Drawing`, and assign its properties a\nmeaningful value:\n\n```php\n$drawing = new \\PhpOffice\\PhpSpreadsheet\\Worksheet\\Drawing();\n$drawing->setName('Logo');\n$drawing->setDescription('Logo');\n$drawing->setPath('./images/officelogo.jpg');\n$drawing->setHeight(36);\n```\n\nTo add the above drawing to the worksheet, use the following snippet of\ncode. PhpSpreadsheet creates the link between the drawing and the\nworksheet:\n\n```php\n$drawing->setWorksheet($spreadsheet->getActiveSheet());\n```\n\nYou can set numerous properties on a drawing, here are some examples:\n\n```php\n$drawing->setName('Paid');\n$drawing->setDescription('Paid');\n$drawing->setPath('./images/paid.png');\n$drawing->setCoordinates('B15');\n$drawing->setOffsetX(110);\n$drawing->setRotation(25);\n$drawing->getShadow()->setVisible(true);\n$drawing->getShadow()->setDirection(45);\n```\n\nYou can also add images created using GD functions without needing to\nsave them to disk first as In-Memory drawings.\n\n```php\n// Use GD to create an in-memory image\n$gdImage = @imagecreatetruecolor(120, 20) or die('Cannot Initialize new GD image stream');\n$textColor = imagecolorallocate($gdImage, 255, 255, 255);\nimagestring($gdImage, 1, 5, 5, 'Created with PhpSpreadsheet', $textColor);\n\n// Add the In-Memory image to a worksheet\n$drawing = new \\PhpOffice\\PhpSpreadsheet\\Worksheet\\MemoryDrawing();\n$drawing->setName('In-Memory image 1');\n$drawing->setDescription('In-Memory image 1');\n$drawing->setCoordinates('A1');\n$drawing->setImageResource($gdImage);\n$drawing->setRenderingFunction(\n \\PhpOffice\\PhpSpreadsheet\\Worksheet\\MemoryDrawing::RENDERING_JPEG\n);\n$drawing->setMimeType(\\PhpOffice\\PhpSpreadsheet\\Worksheet\\MemoryDrawing::MIMETYPE_DEFAULT);\n$drawing->setHeight(36);\n$drawing->setWorksheet($spreadsheet->getActiveSheet());\n```\n\nNote that GD images are memory-intensive.\n\n### Creating a Drawing from string or stream data\n\nIf you want to create a drawing from a string containing the binary image data, or from an external datasource such as an S3 bucket, then you can create a new MemoryDrawing from these sources using the `fromString()` or `fromStream()` static methods.\n\n```php\n$drawing = MemoryDrawing::fromString($imageString);\n```\n\n```php\n$drawing = MemoryDrawing::fromStream($imageStreamFromS3Bucket);\n```\n\nNote that this is a memory-intensive process, like all gd images; and also creates a temporary file.\n\n## Reading Images from a worksheet\n\nA commonly asked question is how to retrieve the images from a workbook\nthat has been loaded, and save them as individual image files to disk.\n\nThe following code extracts images from the current active worksheet,\nand writes each as a separate file.\n\n```php\nuse PhpOffice\\PhpSpreadsheet\\Worksheet\\MemoryDrawing;\n$i = 0;\n\nforeach ($spreadsheet->getActiveSheet()->getDrawingCollection() as $drawing) {\n if ($drawing instanceof MemoryDrawing) {\n ob_start();\n call_user_func(\n $drawing->getRenderingFunction(),\n $drawing->getImageResource()\n );\n $imageContents = ob_get_contents();\n ob_end_clean();\n switch ($drawing->getMimeType()) {\n case MemoryDrawing::MIMETYPE_PNG :\n $extension = 'png';\n break;\n case MemoryDrawing::MIMETYPE_GIF:\n $extension = 'gif';\n break;\n case MemoryDrawing::MIMETYPE_JPEG :\n $extension = 'jpg';\n break;\n }\n } else {\n if ($drawing->getPath()) {\n // Check if the source is a URL or a file path\n if ($drawing->getIsURL()) {\n $imageContents = file_get_contents($drawing->getPath());\n $filePath = tempnam(sys_get_temp_dir(), 'Drawing');\n file_put_contents($filePath , $imageContents);\n $mimeType = mime_content_type($filePath);\n // You could use the below to find the extension from mime type.\n // https://gist.github.com/alexcorvi/df8faecb59e86bee93411f6a7967df2c#gistcomment-2722664\n $extension = File::mime2ext($mimeType);\n unlink($filePath); \n }\n else {\n $zipReader = fopen($drawing->getPath(),'r');\n $imageContents = '';\n while (!feof($zipReader)) {\n $imageContents .= fread($zipReader,1024);\n }\n fclose($zipReader);\n $extension = $drawing->getExtension(); \n }\n }\n }\n $myFileName = '00_Image_'.++$i.'.'.$extension;\n file_put_contents($myFileName,$imageContents);\n}\n```\n\n## Add rich text to a cell\n\nAdding rich text to a cell can be done using\n`\\PhpOffice\\PhpSpreadsheet\\RichText\\RichText` instances. Here''s an example, which\ncreates the following rich text string:\n\n> This invoice is ***payable within thirty days after the end of the\n> month*** unless specified otherwise on the invoice.\n\n```php\n$richText = new \\PhpOffice\\PhpSpreadsheet\\RichText\\RichText();\n$richText->createText('This invoice is ');\n$payable = $richText->createTextRun('payable within thirty days after the end of the month');\n$payable->getFont()->setBold(true);\n$payable->getFont()->setItalic(true);\n$payable->getFont()->setColor(\n new \\PhpOffice\\PhpSpreadsheet\\Style\\Color( \n \\PhpOffice\\PhpSpreadsheet\\Style\\Color::COLOR_DARKGREEN\n )\n);\n$richText->createText(', unless specified otherwise on the invoice.');\n$spreadsheet->getActiveSheet()->getCell('A18')->setValue($richText);\n```\n\n## Define a named range\n\nPhpSpreadsheet supports the definition of named ranges. These can be\ndefined using the following code:\n\n```php\n// Add some data\n$spreadsheet->setActiveSheetIndex(0);\n$spreadsheet->getActiveSheet()->setCellValue('A1', 'Firstname:');\n$spreadsheet->getActiveSheet()->setCellValue('A2', 'Lastname:');\n$spreadsheet->getActiveSheet()->setCellValue('B1', 'Maarten');\n$spreadsheet->getActiveSheet()->setCellValue('B2', 'Balliauw');\n\n// Define named ranges\n$spreadsheet->addNamedRange( new \\PhpOffice\\PhpSpreadsheet\\NamedRange('PersonFN', $spreadsheet->getActiveSheet(), '$B$1'));\n$spreadsheet->addNamedRange( new \\PhpOffice\\PhpSpreadsheet\\NamedRange('PersonLN', $spreadsheet->getActiveSheet(), '$B$2'));\n```\n\nOptionally, a fourth parameter can be passed defining the named range\nlocal (i.e. only usable on the current worksheet). Named ranges are\nglobal by default.\n\n## Define a named formula\n\nIn addition to named ranges, PhpSpreadsheet also supports the definition of named formulas. These can be\ndefined using the following code:\n\n```php\n// Add some data\n$spreadsheet->setActiveSheetIndex(0);\n$worksheet = $spreadsheet->getActiveSheet();\n$worksheet\n ->setCellValue('A1', 'Product')\n ->setCellValue('B1', 'Quantity')\n ->setCellValue('C1', 'Unit Price')\n ->setCellValue('D1', 'Price')\n ->setCellValue('E1', 'VAT')\n ->setCellValue('F1', 'Total');\n\n// Define named formula\n$spreadsheet->addNamedFormula( new \\PhpOffice\\PhpSpreadsheet\\NamedFormula('GERMAN_VAT_RATE', $worksheet, '=16.0%'));\n$spreadsheet->addNamedFormula( new \\PhpOffice\\PhpSpreadsheet\\NamedFormula('CALCULATED_PRICE', $worksheet, '=$B1*$C1'));\n$spreadsheet->addNamedFormula( new \\PhpOffice\\PhpSpreadsheet\\NamedFormula('GERMAN_VAT', $worksheet, '=$D1*GERMAN_VAT_RATE'));\n$spreadsheet->addNamedFormula( new \\PhpOffice\\PhpSpreadsheet\\NamedFormula('TOTAL_INCLUDING_VAT', $worksheet, '=$D1+$E1'));\n\n$worksheet\n ->setCellValue('A2', 'Advanced Web Application Architecture')\n ->setCellValue('B2', 2)\n ->setCellValue('C2', 23.0)\n ->setCellValue('D2', '=CALCULATED_PRICE')\n ->setCellValue('E2', '=GERMAN_VAT')\n ->setCellValue('F2', '=TOTAL_INCLUDING_VAT');\n$spreadsheet->getActiveSheet()\n ->setCellValue('A3', 'Object Design Style Guide')\n ->setCellValue('B3', 5)\n ->setCellValue('C3', 12.0)\n ->setCellValue('D3', '=CALCULATED_PRICE')\n ->setCellValue('E3', '=GERMAN_VAT')\n ->setCellValue('F3', '=TOTAL_INCLUDING_VAT');\n$spreadsheet->getActiveSheet()\n ->setCellValue('A4', 'PHP For the Web')\n ->setCellValue('B4', 3)\n ->setCellValue('C4', 10.0)\n ->setCellValue('D4', '=CALCULATED_PRICE')\n ->setCellValue('E4', '=GERMAN_VAT')\n ->setCellValue('F4', '=TOTAL_INCLUDING_VAT');\n\n// Use a relative named range to provide the totals for rows 2-4\n$spreadsheet->addNamedRange( new \\PhpOffice\\PhpSpreadsheet\\NamedRange('COLUMN_TOTAL', $worksheet, '=A$2:A$4') );\n\n$spreadsheet->getActiveSheet()\n ->setCellValue('B6', '=SUBTOTAL(109,COLUMN_TOTAL)')\n ->setCellValue('D6', '=SUBTOTAL(109,COLUMN_TOTAL)')\n ->setCellValue('E6', '=SUBTOTAL(109,COLUMN_TOTAL)')\n ->setCellValue('F6', '=SUBTOTAL(109,COLUMN_TOTAL)');\n```\n\nAs with named ranges, an optional fourth parameter can be passed defining the named formula\nscope as local (i.e. only usable on the specified worksheet). Otherwise, named formulas are\nglobal by default.\n\n## Redirect output to a client's web browser\n\nSometimes, one really wants to output a file to a client''s browser,\nespecially when creating spreadsheets on-the-fly. There are some easy\nsteps that can be followed to do this:\n\n1. Create your PhpSpreadsheet spreadsheet\n2. Output HTTP headers for the type of document you wish to output\n3. Use the `\\PhpOffice\\PhpSpreadsheet\\Writer\\*` of your choice, and save\n to `'php://output'`\n\n`\\PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx` uses temporary storage when\nwriting to `php://output`. By default, temporary files are stored in the\nscript's working directory. When there is no access, it falls back to\nthe operating system's temporary files location.\n\n**This may not be safe for unauthorized viewing!** Depending on the\nconfiguration of your operating system, temporary storage can be read by\nanyone using the same temporary storage folder. When confidentiality of\nyour document is needed, it is recommended not to use `php://output`.\n\n### HTTP headers\n\nExample of a script redirecting an Excel 2007 file to the client's\nbrowser:\n\n```php\n/* Here there will be some code where you create $spreadsheet */\n\n// redirect output to client browser\nheader('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');\nheader('Content-Disposition: attachment;filename=\"myfile.xlsx\"');\nheader('Cache-Control: max-age=0');\n\n$writer = \\PhpOffice\\PhpSpreadsheet\\IOFactory::createWriter($spreadsheet, 'Xlsx');\n$writer->save('php://output');\n```\n\nExample of a script redirecting an Xls file to the client's browser:\n\n```php\n/* Here there will be some code where you create $spreadsheet */\n\n// redirect output to client browser\nheader('Content-Type: application/vnd.ms-excel');\nheader('Content-Disposition: attachment;filename=\"myfile.xls\"');\nheader('Cache-Control: max-age=0');\n\n$writer = \\PhpOffice\\PhpSpreadsheet\\IOFactory::createWriter($spreadsheet, 'Xls');\n$writer->save('php://output');\n```\n\n**Caution:**\n\nMake sure not to include any echo statements or output any other\ncontents than the Excel file. There should be no whitespace before the\nopening ``\ntag (which can also be omitted to avoid problems). Make sure that your\nscript is saved without a BOM (Byte-order mark) because this counts as\nechoing output. The same things apply to all included files. Failing to\nfollow the above guidelines may result in corrupt Excel files arriving\nat the client browser, and/or that headers cannot be set by PHP\n(resulting in warning messages).\n\n## Setting the default column width\n\nDefault column width can be set using the following code:\n\n```php\n$spreadsheet->getActiveSheet()->getDefaultColumnDimension()->setWidth(12);\n```\n\nExcel measures column width in its own proprietary units, based on the number\nof characters that will be displayed in the default font.\n\nIf you want to set the default column width using a different UoM (Unit of Measure),\nthen you can do so by telling PhpSpreadsheet what UoM the width value\nthat you are setting is measured in.\nValid units are `pt` (points), `px` (pixels), `pc` (pica), `in` (inches),\n`cm` (centimeters) and `mm` (millimeters).\n\n```php\n$spreadsheet->getActiveSheet()->getDefaultColumnDimension()->setWidth(400, 'pt');\n```\nand PhpSpreadsheet will handle the internal conversion.\n\n## Setting the default row height\n\nDefault row height can be set using the following code:\n\n```php\n$spreadsheet->getActiveSheet()->getDefaultRowDimension()->setRowHeight(15);\n```\n\nExcel measures row height in points, where 1 pt is 1/72 of an inch (or\nabout 0.35mm). The default value is 12.75 pts; and the permitted range\nof values is between 0 and 409 pts, where 0 pts is a hidden row.\n\nIf you want to set a row height using a different UoM (Unit of Measure),\nthen you can do so by telling PhpSpreadsheet what UoM the height value\nthat you are setting is measured in.\nValid units are `pt` (points), `px` (pixels), `pc` (pica), `in` (inches),\n`cm` (centimeters) and `mm` (millimeters).\n\n```php\n$spreadsheet->getActiveSheet()->getDefaultRowDimension()->setRowHeight(100, 'pt');\n```\n\n\n## Add a GD drawing to a worksheet\n\nThere might be a situation where you want to generate an in-memory image\nusing GD and add it to a `Spreadsheet` without first having to save this\nfile to a temporary location.\n\nHere''s an example which generates an image in memory and adds it to the\nactive worksheet:\n\n```php\n// Generate an image\n$gdImage = @imagecreatetruecolor(120, 20) or die('Cannot Initialize new GD image stream');\n$textColor = imagecolorallocate($gdImage, 255, 255, 255);\nimagestring($gdImage, 1, 5, 5, 'Created with PhpSpreadsheet', $textColor);\n\n// Add a drawing to the worksheet\n$drawing = new \\PhpOffice\\PhpSpreadsheet\\Worksheet\\MemoryDrawing();\n$drawing->setName('Sample image');\n$drawing->setDescription('Sample image');\n$drawing->setImageResource($gdImage);\n$drawing->setRenderingFunction(\\PhpOffice\\PhpSpreadsheet\\Worksheet\\MemoryDrawing::RENDERING_JPEG);\n$drawing->setMimeType(\\PhpOffice\\PhpSpreadsheet\\Worksheet\\MemoryDrawing::MIMETYPE_DEFAULT);\n$drawing->setHeight(36);\n$drawing->setWorksheet($spreadsheet->getActiveSheet());\n```\n\n## Setting worksheet zoom level\n\nTo set a worksheet's zoom level, the following code can be used:\n\n```php\n$spreadsheet->getActiveSheet()->getSheetView()->setZoomScale(75);\n```\n\nNote that zoom level should be in range 10 - 400.\n\n## Sheet tab color\n\nSometimes you want to set a color for sheet tab. For example you can\nhave a red sheet tab:\n\n```php\n$worksheet->getTabColor()->setRGB('FF0000');\n```\n\n## Creating worksheets in a workbook\n\nIf you need to create more worksheets in the workbook, here is how:\n\n```php\n$worksheet1 = $spreadsheet->createSheet();\n$worksheet1->setTitle('Another sheet');\n```\n\nThink of `createSheet()` as the \"Insert sheet\" button in Excel. When you\nhit that button a new sheet is appended to the existing collection of\nworksheets in the workbook.\n\n## Hidden worksheets (Sheet states)\n\nSet a worksheet to be **hidden** using this code:\n\n```php\n$spreadsheet->getActiveSheet()\n ->setSheetState(\\PhpOffice\\PhpSpreadsheet\\Worksheet\\Worksheet::SHEETSTATE_HIDDEN);\n```\n\nSometimes you may even want the worksheet to be **\"very hidden\"**. The\navailable sheet states are :\n\n- `\\PhpOffice\\PhpSpreadsheet\\Worksheet\\Worksheet::SHEETSTATE_VISIBLE`\n- `\\PhpOffice\\PhpSpreadsheet\\Worksheet\\Worksheet::SHEETSTATE_HIDDEN`\n- `\\PhpOffice\\PhpSpreadsheet\\Worksheet\\Worksheet::SHEETSTATE_VERYHIDDEN`\n\nIn Excel the sheet state \"very hidden\" can only be set programmatically,\ne.g. with Visual Basic Macro. It is not possible to make such a sheet\nvisible via the user interface.\n\n## Right-to-left worksheet\n\nWorksheets can be set individually whether column `A` should start at\nleft or right side. Default is left. Here is how to set columns from\nright-to-left.\n\n```php\n// right-to-left worksheet\n$spreadsheet->getActiveSheet()->setRightToLeft(true);\n```\n" }, { "path": "docs/topics/settings.md", "content": "# Configuration Settings\n\nOnce you have included the PhpSpreadsheet files in your script, but\nbefore instantiating a `Spreadsheet` object or loading a workbook file,\nthere are a number of configuration options that can be set which will\naffect the subsequent behaviour of the script.\n\n## Cell collection caching\n\nBy default, PhpSpreadsheet holds all cell objects in memory, but\nyou can specify alternatives to reduce memory consumption at the cost of speed.\nRead more about [memory saving](./memory_saving.md).\n\nTo enable cell caching, you must provide your own implementation of cache like so:\n\n```php\n$cache = new MyCustomPsr16Implementation();\n\n\\PhpOffice\\PhpSpreadsheet\\Settings::setCache($cache);\n```\n\n## Language/Locale\n\nSome localisation elements have been included in PhpSpreadsheet. You can\nset a locale by changing the settings. To set the locale to Brazilian\nPortuguese you would use:\n\n```php\n$locale = 'pt_br';\n$validLocale = \\PhpOffice\\PhpSpreadsheet\\Settings::setLocale($locale);\nif (!$validLocale) {\n echo 'Unable to set locale to ' . $locale . \" - reverting to en_us\" . PHP_EOL;\n}\n```\n\n- If Brazilian Portuguese language files aren't available, then Portuguese\nwill be enabled instead\n- If Portuguese language files also aren't available,\nthen the `setLocale` method will return `false`, and American English\n(en\\_us) settings will be used throughout.\n\nMore details of the features available once a locale has been set,\nincluding a list of the languages and locales currently supported, can\nbe found in [Locale Settings for\nFormulas](./recipes.md#locale-settings-for-formulas).\n\nAdditional localization elements (currency code, thousands separator, and decimal separator) are available in `PhpOffice\\PhpSpreadsheet\\Shared\\StringHelper`:\n\n```php\nStringHelper::setCurrencyCode('€');\nStringHelper::setThousandsSeparator('.');\nStringHelper::setDecimalSeparator(',');\n```\n\nYou can use the Php function `setLocale` to try to set these values\nwithout knowing beforehand what symbols are needed.\n```php\nStringHelper::setCurrencyCode(null);\nStringHelper::setThousandsSeparator(null);\nStringHelper::setDecimalSeparator(null);\n$result = setLocale(LC_ALL, 'pt_br.UTF-8');\n```\nHowever, this function maintains its information at the process level, not the thread level,\nand its use is therefore discouraged.\n\nA less-troublesome replacement is available starting with PhpSpreadsheet 5.4.\n```php\n$result = StringHelper::setLocale('pt_br'); // will restore defaults if argument is null\n```\nThis will set the locale and the 3 StringHelper values all at once.\nIt requires the `Intl` extension, which is not a requirement for PhpSpreadsheet as a whole.\nFor that reason, it returns a boolean result, which will be `false`\nif `Intl` is not available, or if it does not consider the supplied locale to be valid.\n" }, { "path": "docs/topics/tables.md", "content": "# Tables\n\n## Introduction\n\nTo make managing and analyzing a group of related data easier, you can turn a range of cells into an Excel table (previously known as an Excel list).\n\n## Support\n\nCurrently tables are supported in Xlsx reader and Html Writer\n\nTo enable table formatting for Html writer, use:\n\n```php\n $writer = new HtmlWriter($spreadsheet);\n $writer->setConditionalFormatting(true);\n```" }, { "path": "docs/topics/worksheets.md", "content": "# Worksheets\n\nA worksheet is a collection of cells, formulae, images, graphs, etc. It\nholds all data necessary to represent a spreadsheet worksheet.\n\nWhen you load a workbook from a spreadsheet file, it will be loaded with\nall its existing worksheets (unless you specified that only certain\nsheets should be loaded). When you load from non-spreadsheet files (such\nas a CSV or HTML file) or from spreadsheet formats that don't identify\nworksheets by name (such as SYLK), then a single worksheet called\n\"WorkSheet1\" will be created containing the data from that file.\n\nWhen you instantiate a new workbook, PhpSpreadsheet will create it with\na single worksheet called \"WorkSheet1\".\n\nThe `getSheetCount()` method will tell you the number of worksheets in\nthe workbook; while the `getSheetNames()` method will return a list of\nall worksheets in the workbook, indexed by the order in which their\n\"tabs\" would appear when opened in MS Excel (or other appropriate\nSpreadsheet program).\n\nIndividual worksheets can be accessed by name, or by their index\nposition in the workbook. The index position represents the order that\neach worksheet \"tab\" is shown when the workbook is opened in MS Excel\n(or other appropriate Spreadsheet program). To access a sheet by its\nindex, use the `getSheet()` method.\n\n```php\n// Get the second sheet in the workbook\n// Note that sheets are indexed from 0\n$spreadsheet->getSheet(1);\n```\n\n\nMethods also exist allowing you to reorder the worksheets in the\nworkbook.\n\nTo access a sheet by name, use the `getSheetByName()` method, specifying\nthe name of the worksheet that you want to access.\n\n```php\n// Retrieve the worksheet called 'Worksheet 1'\n$spreadsheet->getSheetByName('Worksheet 1');\n```\n\nAlternatively, one worksheet is always the currently active worksheet,\nand you can access that directly. The currently active worksheet is the\none that will be active when the workbook is opened in MS Excel (or\nother appropriate Spreadsheet program).\n\n```php\n// Retrieve the current active worksheet\n$spreadsheet->getActiveSheet();\n```\n\nYou can change the currently active sheet by index or by name using the\n`setActiveSheetIndex()` and `setActiveSheetIndexByName()` methods.\n\n## Adding a new Worksheet\n\nYou can add a new worksheet to the workbook using the `createSheet()`\nmethod of the `Spreadsheet` object. By default, this will be created as\na new \"last\" sheet; but you can also specify an index position as an\nargument, and the worksheet will be inserted at that position, shuffling\nall subsequent worksheets in the collection down a place.\n\n```php\n$spreadsheet->createSheet();\n```\n\nA new worksheet created using this method will be called\n`Worksheet
My very first example of rich text
generated from html markup
\n\n\nThis block contains an italicized word;\nwhile this block uses an underline.\n\n
\n\nI want to eat healthy food pizza.\n\n';\n\n$html2 = '
\n\n 100°C is a hot temperature\n\n
\n\n 10°F is cold\n\n
Roots:
');\n\n $discriminantFormula = '=POWER(' . $postB . ',2) - (4 * ' . $postA . ' * ' . $postC . ')';\n $discriminant = Calculation::getInstance()->calculateFormula($discriminantFormula);\n $discriminant = StringHelper::convertToString($discriminant);\n\n $r1Formula = '=IMDIV(IMSUM(-' . $postB . ',IMSQRT(' . $discriminant . ')),2 * ' . $postA . ')';\n $r2Formula = '=IF(' . $discriminant . '=0,\"Only one root\",IMDIV(IMSUB(-' . $postB . ',IMSQRT(' . $discriminant . ')),2 * ' . $postA . '))';\n\n /** @var string */\n $output = Calculation::getInstance()->calculateFormula($r1Formula);\n $helper->log(\"$output\");\n /** @var string */\n $output = Calculation::getInstance()->calculateFormula($r2Formula);\n $helper->log(\"$output\");\n $callEndTime = microtime(true);\n $helper->logEndingNotes();\n }\n}\n" }, { "path": "samples/Basic4/46_ReadHtml.php", "content": "load($html);\n\n$helper->logRead('Html', $html, $callStartTime);\n\n// Save\n$helper->write($objPHPExcel, __FILE__);\n" }, { "path": "samples/Basic4/47_xlsfill.php", "content": "log('Read spreadsheet');\n$reader = new Xls();\n$spreadsheet = $reader->load(__DIR__ . '/../templates/47_xlsfill.xls');\n\n// Save\n$helper->write($spreadsheet, __FILE__, ['Xls']);\n$spreadsheet->disconnectWorksheets();\n" }, { "path": "samples/Basic4/47_xlsxfill.php", "content": "log('Read spreadsheet');\n$reader = new Xlsx();\n$spreadsheet = $reader->load(__DIR__ . '/../templates/47_xlsxfill.xlsx');\n\n// Save\n$helper->write($spreadsheet, __FILE__, ['Xlsx']);\n$spreadsheet->disconnectWorksheets();\n" }, { "path": "samples/Basic4/48_Image_move_size_with_cells.php", "content": "log('Create new Spreadsheet object');\n$spreadsheet = new Spreadsheet();\n$sheet = $spreadsheet->getActiveSheet();\n$sheet->getCell('A1')->setValue('twocell');\n$sheet->getCell('A2')->setValue('twocell');\n$sheet->getCell('A3')->setValue('onecell');\n$sheet->getCell('A6')->setValue('absolute');\n\n// Add a drawing to the worksheet\n$helper->log('Add a drawing to the worksheet two-cell anchor not resized');\n$drawing = new Drawing();\n$drawing->setName('PhpSpreadsheet');\n$drawing->setDescription('PhpSpreadsheet');\n$drawing->setPath(__DIR__ . '/../images/PhpSpreadsheet_logo.png');\n// anchor type will be two-cell because Coordinates2 is set\n//$drawing->setAnchorType(Drawing::ANCHORTYPE_TWOCELL);\n$drawing->setCoordinates('B1');\n$drawing->setCoordinates2('B1');\n$drawing->setOffsetX2($drawing->getImageWidth());\n$drawing->setOffsetY2($drawing->getImageHeight());\n$drawing->setWorksheet($spreadsheet->getActiveSheet());\n\n// Add a drawing to the worksheet\n$helper->log('Add a drawing to the worksheet two-cell anchor resized');\n$drawing2 = new Drawing();\n$drawing2->setName('PhpSpreadsheet');\n$drawing2->setDescription('PhpSpreadsheet');\n$drawing2->setPath(__DIR__ . '/../images/PhpSpreadsheet_logo.png');\n// anchor type will be two-cell because Coordinates2 is set\n//$drawing->setAnchorType(Drawing::ANCHORTYPE_TWOCELL);\n$drawing2->setCoordinates('C2');\n$drawing2->setCoordinates2('C2');\n$drawing2->setOffsetX2($drawing->getImageWidth());\n$drawing2->setOffsetY2($drawing->getImageHeight());\n$drawing2->setWorksheet($spreadsheet->getActiveSheet());\n\n$spreadsheet->getActiveSheet()->getColumnDimension('C')->setWidth($drawing->getImageWidth(), Dimension::UOM_PIXELS);\n$spreadsheet->getActiveSheet()->getRowDimension(2)->setRowHeight($drawing->getImageHeight(), Dimension::UOM_PIXELS);\n\n// Add a drawing to the worksheet one cell anchor\n$helper->log('Add a drawing to the worksheet one-cell anchor');\n$drawing3 = new Drawing();\n$drawing3->setName('PhpSpreadsheet');\n$drawing3->setDescription('PhpSpreadsheet');\n$drawing3->setPath(__DIR__ . '/../images/PhpSpreadsheet_logo.png');\n// anchor type will be one-cell because Coordinates2 is not set\n//$drawing->setAnchorType(Drawing::ANCHORTYPE_ONECELL);\n$drawing3->setCoordinates('D3');\n$drawing3->setWorksheet($spreadsheet->getActiveSheet());\n\n// Add a drawing to the worksheet\n$helper->log('Add a drawing to the worksheet two-cell anchor resized absolute');\n$drawing4 = new Drawing();\n$drawing4->setName('PhpSpreadsheet');\n$drawing4->setDescription('PhpSpreadsheet');\n$drawing4->setPath(__DIR__ . '/../images/PhpSpreadsheet_logo.png');\n// anchor type will be two-cell because Coordinates2 is set\n//$drawing->setAnchorType(Drawing::ANCHORTYPE_TWOCELL);\n$drawing4->setCoordinates('C6');\n$drawing4->setCoordinates2('C6');\n$drawing4->setOffsetX2($drawing->getImageWidth());\n$drawing4->setOffsetY2($drawing->getImageHeight());\n$drawing4->setWorksheet($spreadsheet->getActiveSheet());\n$drawing4->setEditAs(Drawing::EDIT_AS_ABSOLUTE);\n\n//$spreadsheet->getActiveSheet()->getColumnDimension('C')->setWidth($drawing->getImageWidth(), Dimension::UOM_PIXELS);\n$spreadsheet->getActiveSheet()->getRowDimension(6)->setRowHeight($drawing->getImageHeight(), Dimension::UOM_PIXELS);\n\n$helper->write($spreadsheet, __FILE__, ['Xlsx']);\n" }, { "path": "samples/Basic4/49_alignment.php", "content": "log('Create new Spreadsheet object');\n$spreadsheet = new Spreadsheet();\n$spreadsheet->getProperties()->setTitle('Alignment');\n$sheet = $spreadsheet->getActiveSheet();\n$hi = 'Hi There';\n$ju = 'This is a longer than normal sentence';\n$sheet->fromArray([\n ['', 'default', 'bottom', 'top', 'center', 'justify', 'distributed'],\n ['default', $hi, $hi, $hi, $hi, $hi, $hi],\n ['left', $hi, $hi, $hi, $hi, $hi, $hi],\n ['right', $hi, $hi, $hi, $hi, $hi, $hi],\n ['center', $hi, $hi, $hi, $hi, $hi, $hi],\n ['justify', $ju, $ju, $ju, $ju, $ju, $ju],\n ['distributed', $ju, $ju, $ju, $ju, $ju, $ju],\n]);\n$sheet->getColumnDimension('B')->setWidth(20);\n$sheet->getColumnDimension('C')->setWidth(20);\n$sheet->getColumnDimension('D')->setWidth(20);\n$sheet->getColumnDimension('E')->setWidth(20);\n$sheet->getColumnDimension('F')->setWidth(20);\n$sheet->getColumnDimension('G')->setWidth(20);\n$sheet->getRowDimension(2)->setRowHeight(30);\n$sheet->getRowDimension(3)->setRowHeight(30);\n$sheet->getRowDimension(4)->setRowHeight(30);\n$sheet->getRowDimension(5)->setRowHeight(30);\n$sheet->getRowDimension(6)->setRowHeight(40);\n$sheet->getRowDimension(7)->setRowHeight(40);\n$minRow = 2;\n$maxRow = 7;\n$minCol = 'B';\n$maxCol = 'g';\n$sheet->getStyle(\"C$minRow:C$maxRow\")\n ->getAlignment()\n ->setVertical(Alignment::VERTICAL_BOTTOM);\n$sheet->getStyle(\"D$minRow:D$maxRow\")\n ->getAlignment()\n ->setVertical(Alignment::VERTICAL_TOP);\n$sheet->getStyle(\"E$minRow:E$maxRow\")\n ->getAlignment()\n ->setVertical(Alignment::VERTICAL_CENTER);\n$sheet->getStyle(\"F$minRow:F$maxRow\")\n ->getAlignment()\n ->setVertical(Alignment::VERTICAL_JUSTIFY);\n$sheet->getStyle(\"G$minRow:G$maxRow\")\n ->getAlignment()\n ->setVertical(Alignment::VERTICAL_DISTRIBUTED);\n$sheet->getStyle(\"{$minCol}3:{$maxCol}3\")\n ->getAlignment()\n ->setHorizontal(Alignment::HORIZONTAL_LEFT);\n$sheet->getStyle(\"{$minCol}4:{$maxCol}4\")\n ->getAlignment()\n ->setHorizontal(Alignment::HORIZONTAL_RIGHT);\n$sheet->getStyle(\"{$minCol}5:{$maxCol}5\")\n ->getAlignment()\n ->setHorizontal(Alignment::HORIZONTAL_CENTER);\n$sheet->getStyle(\"{$minCol}6:{$maxCol}6\")\n ->getAlignment()\n ->setHorizontal(Alignment::HORIZONTAL_JUSTIFY);\n$sheet->getStyle(\"{$minCol}7:{$maxCol}7\")\n ->getAlignment()\n ->setHorizontal(Alignment::HORIZONTAL_DISTRIBUTED);\n\n$sheet->getCell('A9')->setValue('Center Continuous A9-C9');\n$sheet->getStyle('A9:C9')\n ->getAlignment()\n ->setHorizontal(Alignment::HORIZONTAL_CENTER_CONTINUOUS);\n$sheet->getCell('A10')->setValue('Fill');\n$sheet->getStyle('A10')\n ->getAlignment()\n ->setHorizontal(Alignment::HORIZONTAL_FILL);\n$sheet->setSelectedCells('A1');\n\n$helper->write($spreadsheet, __FILE__, ['Xlsx', 'Html', 'Xls']);\n" }, { "path": "samples/Basic5/50_xlsverticalbreak.php", "content": "log('Read spreadsheet');\n$reader = new Xls();\n$spreadsheet = $reader->load(__DIR__ . '/../templates/50_xlsverticalbreak.xls');\n\n// Save\n$helper->write($spreadsheet, __FILE__, ['Xls']);\n$spreadsheet->disconnectWorksheets();\n" }, { "path": "samples/Basic5/51_ProtectedSort.php", "content": "log('First sheet - protected, sorts not allowed');\n$sheet = $spreadsheet->getActiveSheet();\n$sheet->setTitle('sorttrue');\n$sheet->getCell('A1')->setValue(10);\n$sheet->getCell('A2')->setValue(5);\n$sheet->getCell('B1')->setValue(15);\n$protection = $sheet->getProtection();\n$protection->setPassword('testpassword');\n$protection->setSheet(true);\n$protection->setInsertRows(true);\n$protection->setFormatCells(true);\n$protection->setObjects(true);\n$protection->setAutoFilter(false);\n$protection->setSort(true);\n$comment = $sheet->getComment('A1');\n$text = new RichText();\n$text->addText(new TextElement('Sort options should be grayed out. Sheet password to remove protections is testpassword for all sheets.'));\n$comment->setText($text)->setHeight('120pt')->setWidth('120pt');\n\n$helper->log('Second sheet - protected, sorts allowed, but no permitted range defined');\n$sheet = $spreadsheet->createSheet();\n$sheet->setTitle('sortfalse');\n$sheet->getCell('A1')->setValue(10);\n$sheet->getCell('A2')->setValue(5);\n$sheet->getCell('B1')->setValue(15);\n$protection = $sheet->getProtection();\n$protection->setPassword('testpassword');\n$protection->setSheet(true);\n$protection->setInsertRows(true);\n$protection->setFormatCells(true);\n$protection->setObjects(true);\n$protection->setAutoFilter(false);\n$protection->setSort(false);\n$comment = $sheet->getComment('A1');\n$text = new RichText();\n$text->addText(new TextElement('Sort options not grayed out, but no permissible sort range.'));\n$comment->setText($text)->setHeight('120pt')->setWidth('120pt');\n\n$helper->log('Third sheet - protected, sorts allowed, but only on permitted range A:A, no range password needed');\n$sheet = $spreadsheet->createSheet();\n$sheet->setTitle('sortfalsenocolpw');\n$sheet->getCell('A1')->setValue(10);\n$sheet->getCell('A2')->setValue(5);\n$sheet->getCell('C1')->setValue(15);\n$protection = $sheet->getProtection();\n$protection->setPassword('testpassword');\n$protection->setSheet(true);\n$protection->setInsertRows(true);\n$protection->setFormatCells(true);\n$protection->setObjects(true);\n$protection->setAutoFilter(false);\n$protection->setSort(false);\n$sheet->protectCells('A:A');\n$comment = $sheet->getComment('A1');\n$text = new RichText();\n$text->addText(new TextElement('Column A may be sorted without a password. No sort for any other column.'));\n$comment->setText($text)->setHeight('120pt')->setWidth('120pt');\n\n$helper->log('Fourth sheet - protected, sorts allowed, but only on permitted range A:A, and range password needed');\n$sheet = $spreadsheet->createSheet();\n$sheet->setTitle('sortfalsecolpw');\n$sheet->getCell('A1')->setValue(10);\n$sheet->getCell('A2')->setValue(5);\n$sheet->getCell('C1')->setValue(15);\n$protection = $sheet->getProtection();\n$protection->setPassword('testpassword');\n$protection->setSheet(true);\n$protection->setInsertRows(true);\n$protection->setFormatCells(true);\n$protection->setObjects(true);\n$protection->setAutoFilter(false);\n$protection->setSort(false);\n$sheet->protectCells('A:A', 'sortpw', false, 'sortrange');\n$comment = $sheet->getComment('A1');\n$text = new RichText();\n$text->addText(new TextElement('Column A may be sorted with password sortpw. No sort for any other column.'));\n$comment->setText($text)->setHeight('120pt')->setWidth('120pt');\n\n// Save\n$helper->write($spreadsheet, __FILE__, ['Xls', 'Xlsx']);\n$spreadsheet->disconnectWorksheets();\n" }, { "path": "samples/Basic5/52_Currency.php", "content": "log('First sheet - Accounting Wizard');\n$sheet = $spreadsheet->getActiveSheet();\n$sheet->setTitle('Accounting');\n$sheet->getCell('A1')->setValue('Currency');\n$sheet->getCell('B1')->setValue('Decimals');\n$sheet->getCell('C1')->setValue('ThouSep');\n$sheet->getCell('D1')->setValue('Lead');\n$sheet->getCell('E1')->setValue('Spacing');\n$sheet->getCell('F1')->setValue('Neg');\n$sheet->getCell('G1')->setValue('Pos');\n$sheet->getCell('H1')->setValue('Zero');\n$sheet->getCell('I1')->setValue('Neg');\n$sheet->getCell('J1')->setValue('Text');\n$sheet->getCell('L1')->setValue('ActWiz$');\n$sheet->getCell('M1')->setValue('ActWiz€Trl');\n$sheet->freezePane('A2');\n$sheet->getComment('E1')->getText()->createText('ignored, always true for Accounting');\n$sheet->getComment('F1')->getText()->createText('ignored, always () for Accounting');\n\n$sheet->getCell('A2')->setValue('AcctUSD');\n$sheet->getCell('G2')->setValue(1234.56);\n$sheet->getCell('H2')->setValue(0);\n$sheet->getCell('I2')->setValue(-1234.56);\n$sheet->getCell('J2')->setValue('text');\n$sheet->getStyle('G2:J2')->getNumberFormat()->setFormatCode(NumberFormat::FORMAT_ACCOUNTING_USD);\n\n$sheet->getCell('A3')->setValue('AcctEur');\n$sheet->getCell('G3')->setValue(1234.56);\n$sheet->getCell('H3')->setValue(0);\n$sheet->getCell('I3')->setValue(-1234.56);\n$sheet->getCell('J3')->setValue('Text');\n$sheet->getStyle('G3:J3')->getNumberFormat()->setFormatCode(NumberFormat::FORMAT_ACCOUNTING_EUR);\n\n$sheet->getCell('A4')->setValue('AcctWiz￥');\n$sheet->getCell('E4')->setValue(true);\n$sheet->getCell('G4')->setValue(1234.56);\n$sheet->getCell('H4')->setValue(0);\n$sheet->getCell('I4')->setValue(-1234.56);\n$sheet->getCell('J4')->setValue('Text');\n$sheet->getStyle('G4:J4')->applyFromArray(\n [\n 'numberFormat' => [\n 'formatCode' => (new Accounting('￥', currencySymbolSpacing: true))->format(),\n ],\n ]\n);\n\n$sheet->getCell('A5')->setValue('StalePR￥');\n$sheet->getCell('G5')->setValue(1234.56);\n$sheet->getCell('H5')->setValue(0);\n$sheet->getCell('I5')->setValue(-1234.56);\n$sheet->getCell('J5')->setValue('Text');\n$sheet->getStyle('G5:J5')->getNumberFormat()->setFormatCode('_(\"￥\"* #,##0.00_);_(\"￥\"* -#,##0.00_);_(\"￥\"* \"-\"??_);_(@_)');\n\n$sheet->getCell('A6')->setValue('AcctWiz￥');\n$sheet->getCell('E6')->setValue(true);\n$sheet->getCell('F6')->setValue(CurrencyNegative::minus->name);\n$sheet->getCell('G6')->setValue(1234.56);\n$sheet->getCell('H6')->setValue(0);\n$sheet->getCell('I6')->setValue(-1234.56);\n$sheet->getCell('J6')->setValue('Text');\n$sheet->getStyle('G6:J6')->applyFromArray(\n [\n 'numberFormat' => [\n 'formatCode' => (new Accounting('￥', currencySymbolSpacing: true, negative: CurrencyNegative::minus))->format(),\n ],\n ]\n);\n\n$sheet->getCell('A7')->setValue('AcctWiz￥');\n$sheet->getCell('E7')->setValue(false);\n$sheet->getCell('F7')->setValue(CurrencyNegative::minus->name);\n$sheet->getCell('G7')->setValue(1234.56);\n$sheet->getCell('H7')->setValue(0);\n$sheet->getCell('I7')->setValue(-1234.56);\n$sheet->getCell('J7')->setValue('Text');\n$sheet->getStyle('G7:J7')->applyFromArray(\n [\n 'numberFormat' => [\n 'formatCode' => (new Accounting('￥', currencySymbolSpacing: false, negative: CurrencyNegative::minus))->format(),\n ],\n ]\n);\n\n$sheet->getCell('A8')->setValue('AcctWiz￥');\n$sheet->getCell('E8')->setValue(false);\n$sheet->getCell('F8')->setValue(CurrencyNegative::parentheses->name);\n$sheet->getCell('G8')->setValue(1234.56);\n$sheet->getCell('H8')->setValue(0);\n$sheet->getCell('I8')->setValue(-1234.56);\n$sheet->getCell('J8')->setValue('Text');\n$sheet->getStyle('G8:J8')->applyFromArray(\n [\n 'numberFormat' => [\n 'formatCode' => (new Accounting('￥', currencySymbolSpacing: false, negative: CurrencyNegative::parentheses))->format(),\n ],\n ]\n);\n\n$sheet->getCell('A9')->setValue('AcctW HUF');\n$sheet->getCell('E9')->setValue(true);\n$sheet->getCell('G9')->setValue(1234.56);\n$sheet->getCell('H9')->setValue(0);\n$sheet->getCell('I9')->setValue(-1234.56);\n$sheet->getCell('J9')->setValue('Text');\n$sheet->getStyle('G9:J9')->applyFromArray(\n [\n 'numberFormat' => [\n 'formatCode' => (new Accounting('HUF', currencySymbolSpacing: true))->format(),\n ],\n ]\n);\n\n$sheet->getCell('A10')->setValue('AcctW HUF');\n$sheet->getCell('E10')->setValue(true);\n$sheet->getCell('F10')->setValue(CurrencyNegative::redParentheses->name);\n$sheet->getStyle('F10')->getFont()->getColor()->setRgb('FF0000');\n$sheet->getCell('G10')->setValue(1234.56);\n$sheet->getCell('H10')->setValue(0);\n$sheet->getCell('I10')->setValue(-1234.56);\n$sheet->getCell('J10')->setValue('Text');\n$sheet->getStyle('G10:J10')->applyFromArray(\n [\n 'numberFormat' => [\n 'formatCode' => (new Accounting('HUF', currencySymbolSpacing: true, negative: CurrencyNegative::redParentheses))->format(),\n ],\n ]\n);\n\n$sheet->getCell('A11')->setValue('AcctW Kazakh');\n$sheet->getCell('D11')->setValue(false);\n$sheet->getCell('G11')->setValue(1234.56);\n$sheet->getCell('H11')->setValue(0);\n$sheet->getCell('I11')->setValue(-1234.56);\n$sheet->getCell('J11')->setValue('Text');\n$sheet->getStyle('G11:J11')->applyFromArray(\n [\n 'numberFormat' => [\n 'formatCode' => (new Accounting('₸', currencySymbolPosition: Accounting::TRAILING_SYMBOL))->format(),\n ],\n ]\n);\n\n$sheet->getCell('A12')->setValue('AcctW $');\n$sheet->getCell('B12')->setValue(3);\n$sheet->getCell('C12')->setValue(false);\n$sheet->getCell('D12')->setValue(false);\n$sheet->getCell('F12')->setValue(CurrencyNegative::redMinus->name);\n$sheet->getStyle('F12')->getFont()->getColor()->setRgb('FF0000');\n$sheet->getCell('G12')->setValue(1234.56);\n$sheet->getCell('H12')->setValue(0);\n$sheet->getCell('I12')->setValue(-1234.56);\n$sheet->getCell('J12')->setValue('Text');\n$format = new Accounting(\n '$',\n decimals: 3,\n thousandsSeparator: false,\n currencySymbolPosition: Accounting::TRAILING_SYMBOL,\n negative: CurrencyNegative::redMinus\n);\n\n$sheet->getStyle('G12:J12')->applyFromArray(\n [\n 'numberFormat' => [\n 'formatCode' => $format->format(),\n ],\n ]\n);\n\n$sheet->getCell('L2')->setValue(1234.56);\n$sheet->getCell('L3')->setValue(0);\n$sheet->getCell('L4')->setValue(-1234.56);\n$format = new Accounting('$');\n$sheet->getStyle('L2:L4')->applyFromArray(\n [\n 'numberFormat' => [\n 'formatCode' => $format->format(),\n ],\n ]\n);\n\n$sheet->getCell('M2')->setValue(1234.56);\n$sheet->getCell('M3')->setValue(0);\n$sheet->getCell('M4')->setValue(-1234.56);\n$format = new Accounting('€', currencySymbolPosition: Accounting::TRAILING_SYMBOL);\n$sheet->getStyle('M2:M4')->applyFromArray(\n [\n 'numberFormat' => [\n 'formatCode' => $format->format(),\n ],\n ]\n);\n\n$sheet->getColumnDimension('A')->setAutoSize(true);\n$sheet->getColumnDimension('F')->setAutoSize(true);\n$sheet->getColumnDimension('G')->setAutoSize(true);\n$sheet->getColumnDimension('I')->setAutoSize(true);\n$sheet->getColumnDimension('L')->setAutoSize(true);\n$sheet->getColumnDimension('M')->setAutoSize(true);\n$sheet->setSelectedCells('J1');\n\n// second sheet\n\n$helper->log('Second sheet - Currency Wizard');\n$sheet = $spreadsheet->createSheet();\n$sheet->setTitle('Currency');\n$sheet->getCell('A1')->setValue('Currency');\n$sheet->getCell('B1')->setValue('Decimals');\n$sheet->getCell('C1')->setValue('ThouSep');\n$sheet->getCell('D1')->setValue('Lead');\n$sheet->getCell('E1')->setValue('Spacing');\n$sheet->getCell('F1')->setValue('Negative');\n$sheet->getCell('G1')->setValue('Pos');\n$sheet->getCell('H1')->setValue('Zero');\n$sheet->getCell('I1')->setValue('Neg');\n$sheet->getCell('J1')->setValue('Text');\n$sheet->freezePane('A2');\n$sheet->getComment('E1')->getText()->createText('ignored, always false for Currency');\n\n$sheet->getCell('A2')->setValue('CurrUSD');\n$sheet->getCell('G2')->setValue(1234.56);\n$sheet->getCell('H2')->setValue(0);\n$sheet->getCell('I2')->setValue(-1234.56);\n$sheet->getCell('J2')->setValue('text');\n$sheet->getStyle('G2:J2')->getNumberFormat()->setFormatCode(NumberFormat::FORMAT_CURRENCY_USD);\n\n$sheet->getCell('A3')->setValue('CurrEur');\n$sheet->getCell('G3')->setValue(1234.56);\n$sheet->getCell('H3')->setValue(0);\n$sheet->getCell('I3')->setValue(-1234.56);\n$sheet->getCell('J3')->setValue('Text');\n$sheet->getStyle('G3:J3')->getNumberFormat()->setFormatCode(NumberFormat::FORMAT_CURRENCY_EUR);\n\n$sheet->getCell('A4')->setValue('CurrWiz￥');\n$sheet->getCell('E4')->setValue(true);\n$sheet->getCell('G4')->setValue(1234.56);\n$sheet->getCell('H4')->setValue(0);\n$sheet->getCell('I4')->setValue(-1234.56);\n$sheet->getCell('J4')->setValue('Text');\n$sheet->getStyle('G4:J4')->applyFromArray(\n [\n 'numberFormat' => [\n 'formatCode' => (new Currency('￥', currencySymbolSpacing: true))->format(),\n ],\n ]\n);\n\n$sheet->getCell('A5')->setValue('StalePR￥');\n$sheet->getCell('G5')->setValue(1234.56);\n$sheet->getCell('H5')->setValue(0);\n$sheet->getCell('I5')->setValue(-1234.56);\n$sheet->getCell('J5')->setValue('Text');\n$sheet->getStyle('G5:J5')->getNumberFormat()->setFormatCode('￥ #,##0');\n\n$sheet->getCell('A6')->setValue('CurrWiz￥');\n$sheet->getCell('E6')->setValue(true);\n$sheet->getCell('F6')->setValue(CurrencyNegative::minus->name);\n$sheet->getCell('G6')->setValue(1234.56);\n$sheet->getCell('H6')->setValue(0);\n$sheet->getCell('I6')->setValue(-1234.56);\n$sheet->getCell('J6')->setValue('Text');\n$sheet->getStyle('G6:J6')->applyFromArray(\n [\n 'numberFormat' => [\n 'formatCode' => (new Currency('￥', currencySymbolSpacing: true, negative: CurrencyNegative::minus))->format(),\n ],\n ]\n);\n\n$sheet->getCell('A7')->setValue('CurrWiz￥');\n$sheet->getCell('E7')->setValue(false);\n$sheet->getCell('F7')->setValue(CurrencyNegative::minus->name);\n$sheet->getCell('G7')->setValue(1234.56);\n$sheet->getCell('H7')->setValue(0);\n$sheet->getCell('I7')->setValue(-1234.56);\n$sheet->getCell('J7')->setValue('Text');\n$sheet->getStyle('G7:J7')->applyFromArray(\n [\n 'numberFormat' => [\n 'formatCode' => (new Currency('￥', currencySymbolSpacing: false, negative: CurrencyNegative::minus))->format(),\n ],\n ]\n);\n\n$sheet->getCell('A8')->setValue('CurrWiz￥');\n$sheet->getCell('E8')->setValue(false);\n$sheet->getCell('F8')->setValue(CurrencyNegative::parentheses->name);\n$sheet->getCell('G8')->setValue(1234.56);\n$sheet->getCell('H8')->setValue(0);\n$sheet->getCell('I8')->setValue(-1234.56);\n$sheet->getCell('J8')->setValue('Text');\n$sheet->getStyle('G8:J8')->applyFromArray(\n [\n 'numberFormat' => [\n 'formatCode' => (new Currency('￥', currencySymbolSpacing: false, negative: CurrencyNegative::parentheses))->format(),\n ],\n ]\n);\n\n$sheet->getCell('A9')->setValue('CurrW HUF');\n$sheet->getCell('E9')->setValue(true);\n$sheet->getCell('G9')->setValue(1234.56);\n$sheet->getCell('H9')->setValue(0);\n$sheet->getCell('I9')->setValue(-1234.56);\n$sheet->getCell('J9')->setValue('Text');\n$sheet->getStyle('G9:J9')->applyFromArray(\n [\n 'numberFormat' => [\n 'formatCode' => (new Currency('HUF', currencySymbolSpacing: true))->format(),\n ],\n ]\n);\n\n$sheet->getCell('A10')->setValue('CurrW HUF');\n$sheet->getCell('E10')->setValue(true);\n$sheet->getCell('F10')->setValue(CurrencyNegative::redParentheses->name);\n$sheet->getStyle('F10')->getFont()->getColor()->setRgb('FF0000');\n$sheet->getCell('G10')->setValue(1234.56);\n$sheet->getCell('H10')->setValue(0);\n$sheet->getCell('I10')->setValue(-1234.56);\n$sheet->getCell('J10')->setValue('Text');\n$sheet->getStyle('G10:J10')->applyFromArray(\n [\n 'numberFormat' => [\n 'formatCode' => (new Currency('HUF', currencySymbolSpacing: true, negative: CurrencyNegative::redParentheses))->format(),\n ],\n ]\n);\n\n$sheet->getCell('A11')->setValue('CurrW Kazakh');\n$sheet->getCell('D11')->setValue(false);\n$sheet->getCell('G11')->setValue(1234.56);\n$sheet->getCell('H11')->setValue(0);\n$sheet->getCell('I11')->setValue(-1234.56);\n$sheet->getCell('J11')->setValue('Text');\n$sheet->getStyle('G11:J11')->applyFromArray(\n [\n 'numberFormat' => [\n 'formatCode' => (new Currency('₸', currencySymbolPosition: Accounting::TRAILING_SYMBOL))->format(),\n ],\n ]\n);\n\n$sheet->getCell('A12')->setValue('CurrW $');\n$sheet->getCell('B12')->setValue(3);\n$sheet->getCell('C12')->setValue(false);\n$sheet->getCell('D12')->setValue(false);\n$sheet->getCell('F12')->setValue(CurrencyNegative::redMinus->name);\n$sheet->getStyle('F12')->getFont()->getColor()->setRgb('FF0000');\n$sheet->getCell('G12')->setValue(1234.56);\n$sheet->getCell('H12')->setValue(0);\n$sheet->getCell('I12')->setValue(-1234.56);\n$sheet->getCell('J12')->setValue('Text');\n$format = new Currency(\n '$',\n decimals: 3,\n thousandsSeparator: false,\n currencySymbolPosition: Currency::TRAILING_SYMBOL,\n negative: CurrencyNegative::redMinus\n);\n\n$sheet->getStyle('G12:J12')->applyFromArray(\n [\n 'numberFormat' => [\n 'formatCode' => $format->format(),\n ],\n ]\n);\n\n$sheet->getColumnDimension('A')->setAutoSize(true);\n$sheet->getColumnDimension('F')->setAutoSize(true);\n$sheet->getColumnDimension('G')->setAutoSize(true);\n$sheet->getColumnDimension('H')->setAutoSize(true);\n$sheet->getColumnDimension('I')->setAutoSize(true);\n$sheet->setSelectedCells('J1');\n\n// third sheet\n\n$helper->log('Third sheet - CurrencyBase Wizard');\n$sheet = $spreadsheet->createSheet();\n$sheet->setTitle('CurrencyBase');\n$sheet->getCell('A1')->setValue('Currency');\n$sheet->getCell('B1')->setValue('Decimals');\n$sheet->getCell('C1')->setValue('ThouSep');\n$sheet->getCell('D1')->setValue('Lead');\n$sheet->getCell('E1')->setValue('Spacing');\n$sheet->getCell('F1')->setValue('Negative');\n$sheet->getCell('G1')->setValue('Pos');\n$sheet->getCell('H1')->setValue('Zero');\n$sheet->getCell('I1')->setValue('Neg');\n$sheet->getCell('J1')->setValue('Text');\n$sheet->freezePane('A2');\n\n$sheet->getCell('A2')->setValue('StaleAct￥');\n$sheet->getCell('G2')->setValue(1234.56);\n$sheet->getCell('H2')->setValue(0);\n$sheet->getCell('I2')->setValue(-1234.56);\n$sheet->getCell('J2')->setValue('Text');\n$sheet->getStyle('G2:J2')->getNumberFormat()->setFormatCode('_(\"￥\"* #,##0.00_);_(\"￥\"* -#,##0.00_);_(\"￥\"* \"-\"??_);_(@_)');\n\n$sheet->getCell('A3')->setValue('CurBase ￥');\n$sheet->getCell('E3')->setValue(true);\n$sheet->getCell('F3')->setValue(CurrencyNegative::minus->name);\n$sheet->getCell('G3')->setValue(1234.56);\n$sheet->getCell('H3')->setValue(0);\n$sheet->getCell('I3')->setValue(-1234.56);\n$sheet->getCell('J3')->setValue('Text');\n$sheet->getStyle('G3:J3')->applyFromArray(\n [\n 'numberFormat' => [\n 'formatCode' => (new CurrencyBase('￥', currencySymbolSpacing: true, negative: CurrencyNegative::minus))->format(),\n ],\n ]\n);\n$sheet->getCell('G4')->setValue(-1234.56);\n$sheet->getStyle('G4')->applyFromArray(\n [\n 'numberFormat' => [\n 'formatCode' => (new CurrencyBase('￥', currencySymbolSpacing: true, negative: CurrencyNegative::minus))->format(),\n ],\n ]\n);\n$sheet->getCell('G5')->setValue(0);\n$sheet->getStyle('G5')->applyFromArray(\n [\n 'numberFormat' => [\n 'formatCode' => (new CurrencyBase('￥', currencySymbolSpacing: true, negative: CurrencyNegative::minus))->format(),\n ],\n ]\n);\n\n$sheet->getCell('A6')->setValue('StaleCur￥');\n$sheet->getCell('G6')->setValue(1234.56);\n$sheet->getCell('H6')->setValue(0);\n$sheet->getCell('I6')->setValue(-1234.56);\n$sheet->getCell('J6')->setValue('Text');\n$sheet->getStyle('G6:J6')->getNumberFormat()->setFormatCode('￥ #,##0');\n\n$sheet->getCell('A7')->setValue('CurBase ￥');\n$sheet->getCell('B7')->setValue(0);\n$sheet->getCell('G7')->setValue(1234.56);\n$sheet->getCell('H7')->setValue(0);\n$sheet->getCell('I7')->setValue(-1234.56);\n$sheet->getCell('J7')->setValue('Text');\n$sheet->getStyle('G7:J7')->applyFromArray(\n [\n 'numberFormat' => [\n 'formatCode' => (new CurrencyBase('￥', 0))->format(),\n ],\n ]\n);\n\n$sheet->getColumnDimension('A')->setAutoSize(true);\n$sheet->getColumnDimension('F')->setAutoSize(true);\n$sheet->getColumnDimension('G')->setAutoSize(true);\n$sheet->getColumnDimension('H')->setAutoSize(true);\n$sheet->getColumnDimension('I')->setAutoSize(true);\n$sheet->setSelectedCells('J1');\n\n$spreadsheet->setActiveSheetIndex(0);\n\n$helper->write($spreadsheet, __FILE__, ['Xls', 'Xlsx']);\n$spreadsheet->disconnectWorksheets();\n" }, { "path": "samples/Basic5/53_ImageOpacity.php", "content": "getProperties()->setTitle('53_ImageOpacity');\n\n$helper->log('Add image to spreadsheet 6 times with different opacities');\n$sheet = $spreadsheet->getActiveSheet();\n$sheet->setTitle('Squares different opacities');\n$sheet->setShowGridLines(false);\n\n$drawing = new Drawing();\n$drawing->setName('Blue Square opacity not specified');\n$drawing->setPath($path);\n$drawing->setCoordinates('A1');\n$drawing->setCoordinates2('B5');\n$drawing->setWorksheet($sheet);\n\n$drawing = new Drawing();\n$drawing->setName('Blue Square opacity 80%');\n$drawing->setPath($path);\n$drawing->setCoordinates('C1');\n$drawing->setCoordinates2('D5');\n$drawing->setOpacity(80000);\n$drawing->setWorksheet($sheet);\n\n$drawing = new Drawing();\n$drawing->setWorksheet($sheet);\n$drawing->setName('Blue Square opacity 60%');\n$drawing->setPath($path);\n$drawing->setCoordinates('E1');\n$drawing->setCoordinates2('F5');\n$drawing->setOpacity(60000);\n\n$drawing = new Drawing();\n$drawing->setName('Blue Square opacity 40%');\n$drawing->setPath($path);\n$drawing->setCoordinates('A8');\n$drawing->setCoordinates2('B12');\n$drawing->setOpacity(40000);\n$drawing->setWorksheet($sheet);\n\n$drawing = new Drawing();\n$drawing->setName('Blue Square opacity 20%');\n$drawing->setPath($path);\n$drawing->setCoordinates('C8');\n$drawing->setCoordinates2('D12');\n$drawing->setOpacity(20000);\n$drawing->setWorksheet($sheet);\n\n$drawing = new Drawing();\n$drawing->setWorksheet($sheet);\n$drawing->setName('Blue Square opacity 0%');\n$drawing->setPath($path);\n$drawing->setCoordinates('E8');\n$drawing->setCoordinates2('F12');\n$drawing->setOpacity(0);\n\n// Save\n$helper->write($spreadsheet, __FILE__, ['Xlsx', 'Html', 'Dompdf', 'Mpdf']);\n$spreadsheet->disconnectWorksheets();\n" }, { "path": "samples/Basic5/54_ImagesInAndOut.php", "content": "getProperties()->setTitle('53_ImageOpacity');\n\n$sheet = $spreadsheet->getActiveSheet();\n$sheet->setTitle('Images in-cell and out');\n$sheet->setShowGridLines(false);\n\n$helper->log('Add in-cell image to spreadsheet');\n$sheet->setCellValue('B1', 'inside');\n$drawing = new Drawing();\n$drawing->setName('Blue Square in-cell');\n$drawing->setPath($path);\n$sheet->getCell('B2')->setValue($drawing);\n\n$helper->log('Add image over cell to spreadsheet');\n$sheet->setCellValue('C1', 'outside');\n$drawing = new Drawing();\n$drawing->setName('Blue Square out-of-cell');\n$drawing->setPath($path);\n$drawing->setCoordinates('C2');\n$drawing->setCoordinates2('D6');\n$drawing->setWorksheet($sheet);\n\n$helper->log('In-cell supported only for Xlsx');\n$helper->write($spreadsheet, __FILE__, ['Xlsx']);\n$spreadsheet->disconnectWorksheets();\n" }, { "path": "samples/Basic5/55_DefinedStyles.php", "content": "getActiveSheet();\n$array = [\n ['NUMBER', 1, NumberFormat::FORMAT_NUMBER],\n ['NUMBER_0', 1, NumberFormat::FORMAT_NUMBER_0],\n ['NUMBER_00', 1, NumberFormat::FORMAT_NUMBER_00],\n ['NUMBER_COMMA_SEPARATED1', 1234, NumberFormat::FORMAT_NUMBER_COMMA_SEPARATED1],\n ['NUMBER_COMMA_SEPARATED2', 1234, NumberFormat::FORMAT_NUMBER_COMMA_SEPARATED2],\n ['PERCENTAGE', 0.98, NumberFormat::FORMAT_PERCENTAGE],\n ['PERCENTAGE_0', 0.985, NumberFormat::FORMAT_PERCENTAGE_0],\n ['PERCENTAGE_00', 0.9856, NumberFormat::FORMAT_PERCENTAGE_00],\n ['DATE_YYYYMMDD', 46000, NumberFormat::FORMAT_DATE_YYYYMMDD],\n ['DATE_DDMMYYYY', 46000, NumberFormat::FORMAT_DATE_DDMMYYYY],\n ['DATE_DMYSLASH', 46000, NumberFormat::FORMAT_DATE_DMYSLASH],\n ['DATE_DMYMINUS', 46000, NumberFormat::FORMAT_DATE_DMYMINUS],\n ['DATE_DMMINUS', 46000, NumberFormat::FORMAT_DATE_DMMINUS],\n ['DATE_MYMINUS', 46000, NumberFormat::FORMAT_DATE_MYMINUS],\n ['DATE_XLSX14', 46000, NumberFormat::FORMAT_DATE_XLSX14],\n ['DATE_XLSX14_ACTUAL', 46000, NumberFormat::FORMAT_DATE_XLSX14_ACTUAL],\n ['DATE_XLSX15', 46000, NumberFormat::FORMAT_DATE_XLSX15],\n ['DATE_XLSX15_YYYY', 46000, NumberFormat::FORMAT_DATE_XLSX15_YYYY],\n ['DATE_XLSX16', 46000, NumberFormat::FORMAT_DATE_XLSX16],\n ['DATE_XLSX17', 46000, NumberFormat::FORMAT_DATE_XLSX17],\n ['DATE_XLSX22', 46000, NumberFormat::FORMAT_DATE_XLSX22],\n ['DATE_XLSX22_ACTUAL', 46000, NumberFormat::FORMAT_DATE_XLSX22_ACTUAL],\n ['DATE_DATETIME', 46000.25, NumberFormat::FORMAT_DATE_DATETIME],\n ['DATE_DATETIME_BETTER', 46000.25, NumberFormat::FORMAT_DATE_DATETIME_BETTER],\n ['DATE_TIME1', 46000.25, NumberFormat::FORMAT_DATE_TIME1],\n ['DATE_TIME2', 46000.25, NumberFormat::FORMAT_DATE_TIME2],\n ['DATE_TIME3', 46000.25, NumberFormat::FORMAT_DATE_TIME3],\n ['DATE_TIME4', 46000.25, NumberFormat::FORMAT_DATE_TIME4],\n ['DATE_TIME5', 46000.25, NumberFormat::FORMAT_DATE_TIME5],\n ['DATE_TIME6', 46000.25, NumberFormat::FORMAT_DATE_TIME6],\n ['DATE_TIME7', 46000.25, NumberFormat::FORMAT_DATE_TIME7],\n ['DATE_TIME8', 46000.25, NumberFormat::FORMAT_DATE_TIME8],\n [' DATE_TIME_INTERVAL_HMS', 0.0087731481481482, NumberFormat::FORMAT_DATE_TIME_INTERVAL_HMS],\n ['DATE_YYYYMMDDSLASH', 46000, NumberFormat::FORMAT_DATE_YYYYMMDDSLASH],\n ['DATE_LONG_DATE', 46000, NumberFormat::FORMAT_DATE_LONG_DATE],\n ['CURRENCY_USD_INTEGER', 1234.56, NumberFormat::FORMAT_CURRENCY_USD_INTEGER],\n ['CURRENCY_USD', 1234.56, NumberFormat::FORMAT_CURRENCY_USD],\n ['CURRENCY_EUR_INTEGER', 1234.56, NumberFormat::FORMAT_CURRENCY_EUR_INTEGER],\n ['CURRENCY_EUR', 1234.56, NumberFormat::FORMAT_CURRENCY_EUR],\n ['CURRENCY_GBP_INTEGER', 1234.56, NumberFormat::FORMAT_CURRENCY_GBP_INTEGER],\n ['CURRENCY_GBP', 1234.56, NumberFormat::FORMAT_CURRENCY_GBP],\n ['CURRENCY_YEN_YUAN_INTEGER', 1234.56, NumberFormat::FORMAT_CURRENCY_YEN_YUAN_INTEGER],\n ['CURRENCY_YEN_YUAN', 1234.56, NumberFormat::FORMAT_CURRENCY_YEN_YUAN],\n ['ACCOUNTING_USD', 1234.56, NumberFormat::FORMAT_CURRENCY_USD],\n ['ACCOUNTING_EUR', 1234.56, NumberFormat::FORMAT_CURRENCY_EUR],\n ['CUSTOM1', 1234.56, '0.000'],\n ['CUSTOM2', 1234.56, '\"$\"#,##0.00_);[Red]\\(\"$\"#,##0.00\\)'],\n];\n$row = 0;\n$helper->log('Populate spreadsheet');\nforeach ($array as $cells) {\n ++$row;\n $sheet->getCell(\"A$row\")->setValue($cells[0]);\n $sheet->getCell(\"B$row\")->setValue($cells[1]);\n if (!str_starts_with($cells[0], 'DATE')) {\n $sheet->getCell(\"C$row\")->setValue(-$cells[1]);\n }\n $sheet->getStyle(\"B$row:C$row\")\n ->getNumberFormat()\n ->setFormatCode($cells[2]);\n}\n$sheet->getColumnDimension('A')->setAutoSize(true);\n$sheet->getColumnDimension('B')->setAutoSize(true);\n$sheet->getColumnDimension('C')->setAutoSize(true);\n$sheet->setSelectedCells('A1');\n\nfunction threeDecimalPlaces(Style $obj, string $name): void\n{\n $writer = $obj->getWriter();\n $writer->startElement('number:number-style');\n $writer->writeAttribute('style:name', $name);\n $writer->startElement('number:number');\n $writer->writeAttribute('number:decimal-places', '3');\n $writer->writeAttribute('number:min-decimal-places', '3');\n $writer->writeAttribute('number:min-integer-digits', '1');\n $writer->endElement(); // number:number\n $writer->endElement(); // number:number-style\n}\n\nfunction redBrackets(Style $obj, string $name): void\n{\n $writer = $obj->getWriter();\n $writer->startElement('number:currency-style');\n $writer->writeAttribute('style:name', $name . 'P0');\n $writer->writeElement('number:currency-symbol', '$');\n $writer->startElement('number:number');\n $writer->writeAttribute('number:decimal-places', '2');\n $writer->writeAttribute('number:min-decimal-places', '2');\n $writer->writeAttribute('number:min-integer-digits', '1');\n $writer->writeAttribute('number:grouping', 'true');\n $writer->endElement(); // number:number\n $writer->writeElement('number:text', ' ');\n $writer->endElement(); // number:currency-style\n\n $writer->startElement('number:currency-style');\n $writer->writeAttribute('style:name', $name);\n $writer->startElement('style:text-properties');\n $writer->writeAttribute('fo:color', '#FF0000');\n $writer->endElement(); // style:text-properties\n $writer->writeElement('number:text', '($');\n $writer->startElement('number:number');\n $writer->writeAttribute('number:decimal-places', '2');\n $writer->writeAttribute('number:min-decimal-places', '2');\n $writer->writeAttribute('number:min-integer-digits', '1');\n $writer->writeAttribute('number:grouping', 'true');\n $writer->endElement(); // number:number\n $writer->writeElement('number:text', ')');\n $writer->startElement('style:map');\n $writer->writeAttribute('style:condition', 'value()>=0');\n $writer->writeAttribute('style:apply-style-name', $name . 'P0');\n $writer->endElement(); // style:map\n $writer->endElement(); // number:currency-style\n}\n\nfunction writeAdditional(BaseWriter $writer): void\n{\n if (method_exists($writer, 'useAdditionalNumberFormats')) {\n $array = [\n '0.000' => threeDecimalPlaces(...),\n '\"$\"#,##0.00_);[Red]\\(\"$\"#,##0.00\\)' => redBrackets(...),\n ];\n $writer->useAdditionalNumberFormats($array);\n }\n}\n\n$helper->write($spreadsheet, __FILE__, ['Xlsx', 'Ods'], writerCallback: writeAdditional(...));\n$spreadsheet->disconnectWorksheets();\n" }, { "path": "samples/Basic5/56_OdsToISO8601.php", "content": "open($infile) !== true) {\n throw new Exception(\"unable to open zip $infile\");\n }\n $files = ['content.xml', 'styles.xml'];\n $modified = false;\n foreach ($files as $file) {\n $data = $zip->getFromName($file);\n if ($data === false) {\n throw new Exception(\"unable to read member $file\");\n }\n $newData = str_replace('
\n \n getPageHeading();\n"
},
{
"path": "samples/HexEtcConversions/BIN2DEC.php",
"content": "titles($category, $functionName, $description);\n\n// Create new PhpSpreadsheet object\n$spreadsheet = new Spreadsheet();\n$worksheet = $spreadsheet->getActiveSheet();\n\n// Add some data\n$testData = [\n [101],\n [110110],\n [1000000],\n [11111111],\n [100010101],\n [110001100],\n [111111111],\n [1111111111],\n [1100110011],\n [1000000000],\n];\n$testDataCount = count($testData);\n\n$worksheet->fromArray($testData, null, 'A1', true);\n\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $worksheet->setCellValue('B' . $row, '=BIN2DEC(A' . $row . ')');\n}\n\n// Test the formulae\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $helper->log(\n \"(B$row): \"\n . 'Binary ' . $worksheet->getCell(\"A$row\")->getValueString()\n . ' is decimal ' . $worksheet->getCell(\"B$row\")->getCalculatedValueString()\n );\n}\n"
},
{
"path": "samples/HexEtcConversions/BIN2HEX.php",
"content": "titles($category, $functionName, $description);\n\n// Create new PhpSpreadsheet object\n$spreadsheet = new Spreadsheet();\n$worksheet = $spreadsheet->getActiveSheet();\n\n// Add some data\n$testData = [\n [101],\n [110110],\n [1000000],\n [11111111],\n [100010101],\n [110001100],\n [111111111],\n [1111111111],\n [1100110011],\n [1000000000],\n];\n$testDataCount = count($testData);\n\n$worksheet->fromArray($testData, null, 'A1', true);\n\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $worksheet->setCellValue('B' . $row, '=BIN2HEX(A' . $row . ')');\n}\n\n// Test the formulae\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $helper->log(\n \"(B$row): \"\n . 'Binary ' . $worksheet->getCell(\"A$row\")->getValueString()\n . ' is hexadecimal ' . $worksheet->getCell(\"B$row\")->getCalculatedValueString()\n );\n}\n"
},
{
"path": "samples/HexEtcConversions/BIN2OCT.php",
"content": "titles($category, $functionName, $description);\n\n// Create new PhpSpreadsheet object\n$spreadsheet = new Spreadsheet();\n$worksheet = $spreadsheet->getActiveSheet();\n\n// Add some data\n$testData = [\n [101],\n [110110],\n [1000000],\n [11111111],\n [100010101],\n [110001100],\n [111111111],\n [1111111111],\n [1100110011],\n [1000000000],\n];\n$testDataCount = count($testData);\n\n$worksheet->fromArray($testData, null, 'A1', true);\n\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $worksheet->setCellValue('B' . $row, '=BIN2OCT(A' . $row . ')');\n}\n\n// Test the formulae\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $helper->log(\n \"(B$row): \"\n . 'Binary ' . $worksheet->getCell(\"A$row\")->getValueString()\n . ' is octal ' . $worksheet->getCell(\"B$row\")->getCalculatedValueString()\n );\n}\n"
},
{
"path": "samples/HexEtcConversions/DEC2BIN.php",
"content": "titles($category, $functionName, $description);\n\n// Create new PhpSpreadsheet object\n$spreadsheet = new Spreadsheet();\n$worksheet = $spreadsheet->getActiveSheet();\n\n// Add some data\n$testData = [\n [-255],\n [-123],\n [-15],\n [-1],\n [5],\n [7],\n [19],\n [51],\n [121],\n [256],\n [511],\n];\n$testDataCount = count($testData);\n\n$worksheet->fromArray($testData, null, 'A1', true);\n\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $worksheet->setCellValue('B' . $row, '=DEC2BIN(A' . $row . ')');\n}\n\n// Test the formulae\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $helper->log(\n \"(B$row): \"\n . 'Decimal ' . $worksheet->getCell(\"A$row\")->getValueString()\n . ' is binary ' . $worksheet->getCell(\"B$row\")->getCalculatedValueString()\n );\n}\n"
},
{
"path": "samples/HexEtcConversions/DEC2HEX.php",
"content": "titles($category, $functionName, $description);\n\n// Create new PhpSpreadsheet object\n$spreadsheet = new Spreadsheet();\n$worksheet = $spreadsheet->getActiveSheet();\n\n// Add some data\n$testData = [\n [-255],\n [-123],\n [-15],\n [-1],\n [5],\n [7],\n [19],\n [51],\n [121],\n [256],\n [511],\n [12345678],\n];\n$testDataCount = count($testData);\n\n$worksheet->fromArray($testData, null, 'A1', true);\n\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $worksheet->setCellValue('B' . $row, '=DEC2HEX(A' . $row . ')');\n}\n\n// Test the formulae\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $helper->log(\n \"(B$row): \"\n . 'Decimal ' . $worksheet->getCell(\"A$row\")->getValueString()\n . ' is hexadecimal ' . $worksheet->getCell(\"B$row\")->getCalculatedValueString()\n );\n}\n"
},
{
"path": "samples/HexEtcConversions/DEC2OCT.php",
"content": "titles($category, $functionName, $description);\n\n// Create new PhpSpreadsheet object\n$spreadsheet = new Spreadsheet();\n$worksheet = $spreadsheet->getActiveSheet();\n\n// Add some data\n$testData = [\n [-255],\n [-123],\n [-15],\n [-1],\n [5],\n [7],\n [19],\n [51],\n [121],\n [256],\n [511],\n [12345678],\n];\n$testDataCount = count($testData);\n\n$worksheet->fromArray($testData, null, 'A1', true);\n\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $worksheet->setCellValue('B' . $row, '=DEC2OCT(A' . $row . ')');\n}\n\n// Test the formulae\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $helper->log(\n \"(B$row): \"\n . 'Decimal ' . $worksheet->getCell(\"A$row\")->getValueString()\n . ' is octal ' . $worksheet->getCell(\"B$row\")->getCalculatedValueString()\n );\n}\n"
},
{
"path": "samples/HexEtcConversions/HEX2BIN.php",
"content": "titles($category, $functionName, $description);\n\n// Create new PhpSpreadsheet object\n$spreadsheet = new Spreadsheet();\n$worksheet = $spreadsheet->getActiveSheet();\n\n// Add some data\n$testData = [\n [3],\n [8],\n [42],\n [99],\n ['A2'],\n ['F0'],\n ['100'],\n ['128'],\n ['1AB'],\n ['1FF'],\n];\n$testDataCount = count($testData);\n\n$worksheet->fromArray($testData, null, 'A1', true);\n\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $worksheet->setCellValue('B' . $row, '=HEX2BIN(A' . $row . ')');\n}\n\n// Test the formulae\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $helper->log(\n \"(B$row): \"\n . 'Hexadecimal ' . $worksheet->getCell(\"A$row\")->getValueString()\n . ' is binary ' . $worksheet->getCell(\"B$row\")->getCalculatedValueString()\n );\n}\n"
},
{
"path": "samples/HexEtcConversions/HEX2DEC.php",
"content": "titles($category, $functionName, $description);\n\n// Create new PhpSpreadsheet object\n$spreadsheet = new Spreadsheet();\n$worksheet = $spreadsheet->getActiveSheet();\n\n// Add some data\n$testData = [\n ['08'],\n ['42'],\n ['A2'],\n ['400'],\n ['1000'],\n ['1234'],\n ['ABCD'],\n ['C3B0'],\n ['FFFFFFFFF'],\n ['FFFFFFFFFF'],\n ['FFFFFFF800'],\n ['FEDCBA9876'],\n];\n$testDataCount = count($testData);\n\n$worksheet->fromArray($testData, null, 'A1', true);\n\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $worksheet->setCellValue('B' . $row, '=HEX2DEC(A' . $row . ')');\n}\n\n// Test the formulae\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $helper->log(\n \"(B$row): \"\n . 'Hexadecimal ' . $worksheet->getCell(\"A$row\")->getValueString()\n . ' is decimal ' . $worksheet->getCell(\"B$row\")->getCalculatedValueString()\n );\n}\n"
},
{
"path": "samples/HexEtcConversions/HEX2OCT.php",
"content": "titles($category, $functionName, $description);\n\n// Create new PhpSpreadsheet object\n$spreadsheet = new Spreadsheet();\n$worksheet = $spreadsheet->getActiveSheet();\n\n// Add some data\n$testData = [\n ['08'],\n ['42'],\n ['A2'],\n ['400'],\n ['100'],\n ['1234'],\n ['ABCD'],\n ['C3B0'],\n ['FFFFFFFFFF'],\n ['FFFFFFF800'],\n];\n$testDataCount = count($testData);\n\n$worksheet->fromArray($testData, null, 'A1', true);\n\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $worksheet->setCellValue('B' . $row, '=HEX2OCT(A' . $row . ')');\n}\n\n// Test the formulae\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $helper->log(\n \"(B$row): \"\n . 'Hexadecimal ' . $worksheet->getCell(\"A$row\")->getValueString()\n . ' is octal ' . $worksheet->getCell(\"B$row\")->getCalculatedValueString()\n );\n}\n"
},
{
"path": "samples/HexEtcConversions/OCT2BIN.php",
"content": "titles($category, $functionName, $description);\n\n// Create new PhpSpreadsheet object\n$spreadsheet = new Spreadsheet();\n$worksheet = $spreadsheet->getActiveSheet();\n\n// Add some data\n$testData = [\n [3],\n [7],\n [42],\n [70],\n [72],\n [77],\n [100],\n [127],\n [177],\n [456],\n [567],\n];\n$testDataCount = count($testData);\n\n$worksheet->fromArray($testData, null, 'A1', true);\n\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $worksheet->setCellValue('B' . $row, '=OCT2BIN(A' . $row . ')');\n}\n\n// Test the formulae\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $helper->log(\n \"(B$row): \"\n . 'Octal ' . $worksheet->getCell(\"A$row\")->getValueString()\n . ' is binary ' . $worksheet->getCell(\"B$row\")->getCalculatedValueString()\n );\n}\n"
},
{
"path": "samples/HexEtcConversions/OCT2DEC.php",
"content": "titles($category, $functionName, $description);\n\n// Create new PhpSpreadsheet object\n$spreadsheet = new Spreadsheet();\n$worksheet = $spreadsheet->getActiveSheet();\n\n// Add some data\n$testData = [\n [3],\n [7],\n [42],\n [70],\n [72],\n [77],\n [100],\n [127],\n [177],\n [456],\n [4567],\n [7777700001],\n [7777776543],\n];\n$testDataCount = count($testData);\n\n$worksheet->fromArray($testData, null, 'A1', true);\n\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $worksheet->setCellValue('B' . $row, '=OCT2DEC(A' . $row . ')');\n}\n\n// Test the formulae\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $helper->log(\n \"(B$row): \"\n . 'Octal ' . $worksheet->getCell(\"A$row\")->getValueString()\n . ' is decimal ' . $worksheet->getCell(\"B$row\")->getCalculatedValueString()\n );\n}\n"
},
{
"path": "samples/HexEtcConversions/OCT2HEX.php",
"content": "titles($category, $functionName, $description);\n\n// Create new PhpSpreadsheet object\n$spreadsheet = new Spreadsheet();\n$worksheet = $spreadsheet->getActiveSheet();\n\n// Add some data\n$testData = [\n [3],\n [12],\n [42],\n [70],\n [72],\n [77],\n [100],\n [127],\n [177],\n [456],\n [4567],\n [7777700001],\n [7777776543],\n];\n$testDataCount = count($testData);\n\n$worksheet->fromArray($testData, null, 'A1', true);\n\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $worksheet->setCellValue('B' . $row, '=OCT2HEX(A' . $row . ')');\n}\n\n// Test the formulae\nfor ($row = 1; $row <= $testDataCount; ++$row) {\n $helper->log(\n \"(B$row): \"\n . 'Octal ' . $worksheet->getCell(\"A$row\")->getValueString()\n . ' is hexadecimal ' . $worksheet->getCell(\"B$row\")->getCalculatedValueString()\n );\n}\n"
},
{
"path": "samples/Html/html_01_Basic_Conditional_Formatting.php",
"content": "isCli() ? ('samples/templates/' . $inputFileName) : ('> $original */\nfunction displaySortedCols(array $original, Sample $helper): void\n{\n $sorted = $original;\n $sortExcelCols = new SortExcelCols();\n $helper->log('Sort by least significant column (descending)');\n $sortExcelCols->sortArray($sorted, arrayCol: 2, ascending: -1);\n $helper->log('Sort by middle column (ascending)');\n $sortExcelCols->sortArray($sorted, arrayCol: 1, ascending: 1);\n $helper->log('Sort by most significant column (descending)');\n $sortExcelCols->sortArray($sorted, arrayCol: 0, ascending: -1);\n $outArray = [['Original', '', '', 'Sorted', '', '']];\n $count = count($original);\n /** @var string[][] $sorted */\n for ($i = 0; $i < $count; ++$i) {\n $outArray[] = [\n $original[$i][0],\n $original[$i][1],\n $original[$i][2],\n $sorted[$i][0],\n $sorted[$i][1],\n $sorted[$i][2],\n ];\n }\n $helper->displayGrid($outArray, TextGridRightAlign::floatOrInt);\n}\n\ndisplaySortedCols($array, $helper);\n"
},
{
"path": "samples/LookupRef/VLOOKUP.php",
"content": "log('Searches for a value in the top row of a table or an array of values,\n and then returns a value in the same column from a row you specify\n in the table or array.');\n\n// Create new PhpSpreadsheet object\n$spreadsheet = new Spreadsheet();\n$worksheet = $spreadsheet->getActiveSheet();\n\n$data = [\n ['ID', 'First Name', 'Last Name', 'Salary'],\n [72, 'Emily', 'Smith', 64901],\n [66, 'James', 'Anderson', 70855],\n [14, 'Mia', 'Clark', 188657],\n [30, 'John', 'Lewis', 97566],\n [53, 'Jessica', 'Walker', 58339],\n [56, 'Mark', 'Reed', 125180],\n [79, 'Richard', 'Lopez', 91632],\n];\n\n$worksheet->fromArray($data, null, 'B2');\n\n$lookupFields = [\n ['ID', 53, 66, 56],\n ['Name'],\n ['Salary'],\n];\n\n$worksheet->fromArray($lookupFields, null, 'G3');\n\n$worksheet->getCell('H4')->setValue('=VLOOKUP(H3, B3:E9, 2, FALSE) & \" \" & VLOOKUP(H3, B3:E9, 3, FALSE)');\n$worksheet->getCell('I4')->setValue('=VLOOKUP(I3, B3:E9, 2, FALSE) & \" \" & VLOOKUP(I3, B3:E9, 3, FALSE)');\n$worksheet->getCell('J4')->setValue('=VLOOKUP(J3, B3:E9, 2, FALSE) & \" \" & VLOOKUP(J3, B3:E9, 3, FALSE)');\n$worksheet->getCell('H5')->setValue('=VLOOKUP(H3, B3:E9, 4, FALSE)');\n$worksheet->getCell('I5')->setValue('=VLOOKUP(I3, B3:E9, 4, FALSE)');\n$worksheet->getCell('J5')->setValue('=VLOOKUP(J3, B3:E9, 4, FALSE)');\n\nfor ($column = 'H'; $column !== 'K'; StringHelper::stringIncrement($column)) {\n for ($row = 4; $row <= 5; ++$row) {\n $cell = $worksheet->getCell(\"{$column}{$row}\");\n $helper->log(\"{$column}{$row}: \" . $cell->getValueString() . ' => ' . $cell->getCalculatedValueString());\n }\n}\n"
},
{
"path": "samples/Pdf/21_Pdf_Domdf.php",
"content": "log('Hide grid lines');\n$spreadsheet->getActiveSheet()->setShowGridLines(false);\n\n$helper->log('Set orientation to landscape');\n$spreadsheet->getActiveSheet()->getPageSetup()->setOrientation(PageSetup::ORIENTATION_LANDSCAPE);\n\n$className = PhpOffice\\PhpSpreadsheet\\Writer\\Pdf\\Dompdf::class;\n$helper->log(\"Write to PDF format using {$className}\");\nIOFactory::registerWriter('Pdf', $className);\n\n// Save\n$helper->write($spreadsheet, __FILE__, ['Pdf']);\n"
},
{
"path": "samples/Pdf/21_Pdf_TCPDF.php",
"content": "log('Hide grid lines');\n$spreadsheet->getActiveSheet()->setShowGridLines(false);\n\n$helper->log('Set orientation to landscape');\n$spreadsheet->getActiveSheet()->getPageSetup()->setOrientation(PageSetup::ORIENTATION_LANDSCAPE);\n\n$className = PhpOffice\\PhpSpreadsheet\\Writer\\Pdf\\Tcpdf::class;\n$helper->log(\"Write to PDF format using {$className}\");\nIOFactory::registerWriter('Pdf', $className);\n\n// Save\n$helper->write($spreadsheet, __FILE__, ['Pdf']);\n"
},
{
"path": "samples/Pdf/21_Pdf_mPDF.php",
"content": "log('Hide grid lines');\n$spreadsheet->getActiveSheet()->setShowGridLines(false);\n\n$helper->log('Set orientation to landscape');\n$spreadsheet->getActiveSheet()->getPageSetup()->setOrientation(PageSetup::ORIENTATION_LANDSCAPE);\n\n$className = PhpOffice\\PhpSpreadsheet\\Writer\\Pdf\\Mpdf::class;\n$helper->log(\"Write to PDF format using {$className}\");\nIOFactory::registerWriter('Pdf', $className);\n\n// Save\n$helper->write($spreadsheet, __FILE__, ['Pdf']);\n"
},
{
"path": "samples/Pdf/21a_Pdf.php",
"content": "log('Hide grid lines');\n$spreadsheet->getActiveSheet()->setShowGridLines(false);\n\n$helper->log('Set orientation to landscape');\n$spreadsheet->getActiveSheet()->getPageSetup()->setOrientation(PageSetup::ORIENTATION_LANDSCAPE);\n$spreadsheet->setActiveSheetIndex(0)->setPrintGridlines(true);\n// Issue 2299 - mpdf can't handle hide rows without kludge\n$spreadsheet->getActiveSheet()->getRowDimension(2)->setVisible(false);\n\nfunction changeGridlines(string $html): string\n{\n return str_replace('{border: 1px solid black;}', '{border: 2px dashed red;}', $html);\n}\n\n$helper->log('Write to Mpdf');\nIOFactory::registerWriter('Pdf', Mpdf::class);\n$helper->write(\n $spreadsheet,\n __FILE__,\n ['Pdf'],\n false,\n function (Mpdf $writer): void {\n $writer->setEmbedImages(true);\n $writer->setEditHtmlCallback('changeGridlines');\n }\n);\n"
},
{
"path": "samples/Pdf/21b_Pdf.php",
"content": ".*~ms';\n $bodyrepl = <<\n
';\n}\n$spreadsheet->disconnectWorksheets();\n" }, { "path": "samples/Pdf/21f_Drawing.php", "content": "getActiveSheet();\n\n$sheet->getCell('A1')->setValue('A1');\n$sheet->getCell('B1')->setValue('B');\n$sheet->getCell('C1')->setValue('C');\n$sheet->getCell('D1')->setValue('D');\n$sheet->getCell('E1')->setValue('E');\n$sheet->getCell('F1')->setValue('F');\n$sheet->getCell('G1')->setValue('G');\n$sheet->getCell('A2')->setValue('A2');\n$sheet->getCell('A3')->setValue('A3');\n$sheet->getCell('A4')->setValue('A4');\n$sheet->getCell('A5')->setValue('A5');\n$sheet->getCell('A6')->setValue('A6');\n$sheet->getCell('A7')->setValue('A7');\n$sheet->getCell('A8')->setValue('A8');\n\n$helper->log('Add drawing to worksheet');\n$drawing = new Drawing();\n$drawing->setName('Blue Square');\n$path = __DIR__ . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . 'images/blue_square.png';\n$drawing->setPath($path);\n$drawing->setResizeProportional(false);\n$drawing->setWidth(320);\n$drawing->setCoordinates('B2');\n$drawing->setCoordinates2('G6');\n$drawing->setWorksheet($sheet, true);\n\n$helper->log('Merge drawing cells for Pdf');\n$spreadsheet->mergeDrawingCellsForPdf();\n\n$helper->log('Write to Mpdf');\n$helper->write($spreadsheet, __FILE__, ['Mpdf']);\n\n$spreadsheet->disconnectWorksheets();\n" }, { "path": "samples/Pdf/21g_Direction.php", "content": "getActiveSheet();\n\n$sheet1 = $spreadsheet->getActiveSheet();\n$sheet2 = $spreadsheet->createSheet();\n$sheet3 = $spreadsheet->createSheet();\n$cells = [\n ['a1', 'b1', 'c1'],\n ['a2', 'b2', 'c2'],\n];\n$sheet1->fromArray($cells);\n$sheet1->setRightToLeft(true);\n$sheet2->fromArray($cells);\n$sheet3->fromArray($cells);\n$sheet3->setRightToLeft(true);\n\n$helper->log('Write to html, mpdf, tcpdf');\n// Save\n$helper->write($spreadsheet, __FILE__, ['Html', 'Mpdf', 'Tcpdf']);\n\n$spreadsheet->disconnectWorksheets();\n" }, { "path": "samples/Pdf/21h_DirectionMultiple.php", "content": "getActiveSheet();\n\n$sheet1 = $spreadsheet->getActiveSheet();\n$sheet2 = $spreadsheet->createSheet();\n$sheet3 = $spreadsheet->createSheet();\n$cells = [\n ['a1', 'b1', 'c1'],\n ['a2', 'b2', 'c2'],\n];\n$sheet1->fromArray($cells);\n$sheet1->setRightToLeft(true);\n$sheet2->fromArray($cells);\n$sheet3->fromArray($cells);\n$sheet3->setRightToLeft(true);\n\n$helper->log('Write to html, mpdf');\n// Save\n$helper->write(\n $spreadsheet,\n __FILE__,\n ['Html', 'Mpdf'],\n writerCallback: function (HtmlWriter $writer): void {\n $writer->writeAllSheets();\n }\n);\n\n$spreadsheet->disconnectWorksheets();\n" }, { "path": "samples/Pdf/Dompdf_Canvas_Headers.php", "content": "getCanvas()->page_script(function (\n int $pageNumber,\n int $pageCount,\n Canvas $canvas,\n FontMetrics $fontMetrics\n ): void {\n // Get font metrics for dynamic content like page numbers\n $fontName = 'helvetica'; // note lowercase\n $fontType = 'bold'; // note lowercase\n $font = $fontMetrics->getFont($fontName, $fontType) ?? throw new Exception(\"no font metrics for $fontName $fontType\");\n // Example text placement (adjust coordinates and font as needed)\n if ($pageNumber === 1) {\n $header = 'Dompdf First Page';\n } elseif ($pageNumber % 2 === 0) {\n $header = 'Dompdf Even Page';\n } else {\n $header = 'Dompdf Odd Page';\n }\n $text = \"$header Page $pageNumber of $pageCount\";\n $canvas->text(40, 20, $text, $font, 12);\n });\n }\n}\n\n$spreadsheet = new Spreadsheet();\n$sheet = $spreadsheet->getActiveSheet();\n$counter = 0;\n/** @var PhpOffice\\PhpSpreadsheet\\Helper\\Sample $helper */\n$helper->log('Populate spreadsheet');\nfor ($row = 1; $row < 1001; ++$row) {\n $sheet->getCell(\"A$row\")->setValue(++$counter);\n // Add many styles by using slight variations of font color for each.\n $sheet->getCell(\"A$row\")->getStyle()->getFont()\n ->getColor()->setRgb(sprintf('%06x', $counter));\n $sheet->getCell(\"B$row\")->setValue(++$counter);\n $sheet->getCell(\"C$row\")->setValue(++$counter);\n}\n\n$helper->log('Write to Dompdf with headers added by page_script');\nIOFactory::registerWriter('Pdf', Dompdf_Canvas_Headers::class);\n$helper->write($spreadsheet, __FILE__, ['Pdf']);\n$spreadsheet->disconnectWorksheets();\n" }, { "path": "samples/Pdf/Dompdf_Custom_Headers.php", "content": "\n header {\n position: fixed;\n top: -0.5in; /* Position in top margin area */\n height: 0.5in;\n width: 100%;\n text-align: center;\n }\n footer {\n position: fixed;\n bottom: -0.5in; /* Position in bottom margin area */\n height: 0.5in;\n width: 100%;\n text-align: right;\n }\n .pagenum:before {content: counter(page);}\n \n\n EOF;\n $endhead = '';\n $html = str_replace($endhead, \"$headerFooter$endhead\", $html);\n $bodystring = '';\n $bodyrepl = <<\n Dompdf Fixed header \n \n EOF;\n\n return str_replace($bodystring, $bodyrepl, $html);\n}\n\n$spreadsheet = new Spreadsheet();\n$sheet = $spreadsheet->getActiveSheet();\n$counter = 0;\n/** @var PhpOffice\\PhpSpreadsheet\\Helper\\Sample $helper */\n$helper->log('Populate spreadsheet');\nfor ($row = 1; $row < 1001; ++$row) {\n $sheet->getCell(\"A$row\")->setValue(++$counter);\n // Add many styles by using slight variations of font color for each.\n $sheet->getCell(\"A$row\")->getStyle()->getFont()\n ->getColor()->setRgb(sprintf('%06x', $counter));\n $sheet->getCell(\"B$row\")->setValue(++$counter);\n $sheet->getCell(\"C$row\")->setValue(++$counter);\n}\n\n$helper->log('Write to Dompdf');\nIOFactory::registerWriter('Pdf', Dompdf::class);\n$helper->write(\n $spreadsheet,\n __FILE__,\n ['Pdf'],\n false,\n function (Dompdf $writer): void {\n $writer->setEditHtmlCallback('addHeadersFootersDompdf2000');\n }\n);\n$spreadsheet->disconnectWorksheets();\n"
},
{
"path": "samples/Pdf/Mpdf_Custom_Headers.php",
"content": "/';\n $simulatedBodyStart = Mpdf::SIMULATED_BODY_START;\n $bodyrepl = <<\n \n\n \n $simulatedBodyStart\n\n EOF;\n\n return preg_replace($bodystring, $bodyrepl, $html) ?? throw new SpreadsheetException('preg 2 failed');\n}\n\n$spreadsheet = new Spreadsheet();\n$sheet = $spreadsheet->getActiveSheet();\n$counter = 0;\n/** @var PhpOffice\\PhpSpreadsheet\\Helper\\Sample $helper */\n$helper->log('Populate spreadsheet');\nfor ($row = 1; $row < 1001; ++$row) {\n $sheet->getCell(\"A$row\")->setValue(++$counter);\n // Add many styles by using slight variations of font color for each.\n $sheet->getCell(\"A$row\")->getStyle()->getFont()\n ->getColor()->setRgb(sprintf('%06x', $counter));\n $sheet->getCell(\"B$row\")->setValue(++$counter);\n $sheet->getCell(\"C$row\")->setValue(++$counter);\n}\n\n$helper->log('Write to Mpdf');\nIOFactory::registerWriter('Pdf', Mpdf::class);\n$helper->write(\n $spreadsheet,\n __FILE__,\n ['Pdf'],\n false,\n function (Mpdf $writer): void {\n $writer->setEditHtmlCallback('addHeadersFootersMpdf2000');\n }\n);\n$spreadsheet->disconnectWorksheets();\n"
},
{
"path": "samples/Pdf/Tcpdf_Custom_Headers.php",
"content": "defines();\n\n return new Tcpdf2Class($orientation, $unit, $paperSize);\n }\n}\n\n// Override vendor class.\nclass Tcpdf2Class extends VendorTcpdf // phpcs:ignore\n{\n // Page header\n public function Header(): void // phpcs:ignore\n {\n // Position at 15 mm from top\n $this->setY(15);\n // Set font\n $this->setFont('helvetica', 'B', 12);\n // Title\n $pageNum = $this->getPage();\n if ($pageNum === 1) {\n $this->Cell(0, 15, 'Tcpdf first header', 0, 0, 'C', false, '', 0, false, 'M', 'M');\n } elseif ($pageNum % 2 === 0) {\n $this->Cell(0, 15, 'Tcpdf even header', 0, 0, 'C', false, '', 0, false, 'M', 'M');\n } else {\n $this->Cell(0, 15, 'Tcpdf odd header', 0, 0, 'C', false, '', 0, false, 'M', 'M');\n }\n }\n\n // Page footer\n public function Footer(): void // phpcs:ignore\n {\n // Position at 15 mm from bottom\n $this->setY(-15);\n // Set font\n $this->setFont('helvetica', 'I', 8);\n // Page number\n $this->Cell(0, 10, 'Page ' . $this->getAliasNumPage() . '/' . $this->getAliasNbPages(), 0, 0, 'C', false, '', 0, false, 'T', 'M');\n }\n}\n\n$spreadsheet = new Spreadsheet();\n$sheet = $spreadsheet->getActiveSheet();\n$counter = 0;\n/** @var PhpOffice\\PhpSpreadsheet\\Helper\\Sample $helper */\n$helper->log('Populate spreadsheet');\nfor ($row = 1; $row < 1001; ++$row) {\n $sheet->getCell(\"A$row\")->setValue(++$counter);\n // Add many styles by using slight variations of font color for each.\n $sheet->getCell(\"A$row\")->getStyle()->getFont()\n ->getColor()->setRgb(sprintf('%06x', $counter));\n $sheet->getCell(\"B$row\")->setValue(++$counter);\n $sheet->getCell(\"C$row\")->setValue(++$counter);\n}\n\n$helper->log('Write to Tcpdf with headers and footers');\nIOFactory::registerWriter('Pdf', Tcpdf2::class);\n$helper->write($spreadsheet, __FILE__, ['Pdf']);\n$spreadsheet->disconnectWorksheets();\n"
},
{
"path": "samples/Reader/01_Simple_file_reader_using_IOFactory.php",
"content": "log('Loading file ' . pathinfo($inputFileName, PATHINFO_BASENAME) . ' using IOFactory to identify the format');\n$spreadsheet = IOFactory::load($inputFileName);\n\n$sheetData = $spreadsheet->getActiveSheet()->toArray(null, true, true, true);\n$helper->displayGrid($sheetData);\n"
},
{
"path": "samples/Reader/02_Simple_file_reader_using_a_specified_reader.php",
"content": "log('Loading file ' . pathinfo($inputFileName, PATHINFO_BASENAME) . ' using ' . Xls::class);\n$reader = new Xls();\n$spreadsheet = $reader->load($inputFileName);\n\n$sheetData = $spreadsheet->getActiveSheet()->toArray(null, true, true, true);\n$helper->displayGrid($sheetData);\n"
},
{
"path": "samples/Reader/03_Simple_file_reader_using_the_IOFactory_to_return_a_reader.php",
"content": "log('Loading file ' . pathinfo($inputFileName, PATHINFO_BASENAME) . ' using IOFactory with a defined reader type of ' . $inputFileType);\n$reader = IOFactory::createReader($inputFileType);\n$spreadsheet = $reader->load($inputFileName);\n\n$sheetData = $spreadsheet->getActiveSheet()->toArray(null, true, true, true);\n$helper->displayGrid($sheetData);\n"
},
{
"path": "samples/Reader/04_Simple_file_reader_using_the_IOFactory_to_identify_a_reader_to_use.php",
"content": "log('File ' . pathinfo($inputFileName, PATHINFO_BASENAME) . ' has been identified as an ' . $inputFileType . ' file');\n\n$helper->log('Loading file ' . pathinfo($inputFileName, PATHINFO_BASENAME) . ' using IOFactory with the identified reader type');\n$reader = IOFactory::createReader($inputFileType);\n$spreadsheet = $reader->load($inputFileName);\n\n$sheetData = $spreadsheet->getActiveSheet()->toArray(null, true, true, true);\n$helper->displayGrid($sheetData);\n"
},
{
"path": "samples/Reader/05_Simple_file_reader_using_the_read_data_only_option.php",
"content": "log('Loading file ' . pathinfo($inputFileName, PATHINFO_BASENAME) . ' using IOFactory with a defined reader type of ' . $inputFileType);\n$reader = IOFactory::createReader($inputFileType);\n$helper->log('Turning Formatting off for Load');\n$reader->setReadDataOnly(true);\n$spreadsheet = $reader->load($inputFileName);\n\n$sheetData = $spreadsheet->getActiveSheet()->toArray(null, true, true, true);\n$helper->displayGrid($sheetData);\n"
},
{
"path": "samples/Reader/06_Simple_file_reader_loading_all_worksheets.php",
"content": "log('Loading file ' . pathinfo($inputFileName, PATHINFO_BASENAME) . ' using IOFactory with a defined reader type of ' . $inputFileType);\n$reader = IOFactory::createReader($inputFileType);\n$helper->log('Loading all WorkSheets');\n$reader->setLoadAllSheets();\n$spreadsheet = $reader->load($inputFileName);\n\n$helper->log($spreadsheet->getSheetCount() . ' worksheet' . (($spreadsheet->getSheetCount() == 1) ? '' : 's') . ' loaded');\n$loadedSheetNames = $spreadsheet->getSheetNames();\nforeach ($loadedSheetNames as $sheetIndex => $loadedSheetName) {\n $helper->log($sheetIndex . ' -> ' . $loadedSheetName);\n}\n"
},
{
"path": "samples/Reader/07_Simple_file_reader_loading_a_single_named_worksheet.php",
"content": "log('Loading file ' . pathinfo($inputFileName, PATHINFO_BASENAME) . ' using IOFactory with a defined reader type of ' . $inputFileType);\n$reader = IOFactory::createReader($inputFileType);\n$helper->log('Loading Sheet \"' . $sheetname . '\" only');\n$reader->setLoadSheetsOnly($sheetname);\n$spreadsheet = $reader->load($inputFileName);\n\n$helper->log($spreadsheet->getSheetCount() . ' worksheet' . (($spreadsheet->getSheetCount() == 1) ? '' : 's') . ' loaded');\n$loadedSheetNames = $spreadsheet->getSheetNames();\nforeach ($loadedSheetNames as $sheetIndex => $loadedSheetName) {\n $helper->log($sheetIndex . ' -> ' . $loadedSheetName);\n}\n"
},
{
"path": "samples/Reader/08_Simple_file_reader_loading_several_named_worksheets.php",
"content": "log('Loading file ' . pathinfo($inputFileName, PATHINFO_BASENAME) . ' using IOFactory with a defined reader type of ' . $inputFileType);\n$reader = IOFactory::createReader($inputFileType);\n$helper->log('Loading Sheets \"' . implode('\" and \"', $sheetnames) . '\" only');\n$reader->setLoadSheetsOnly($sheetnames);\n$spreadsheet = $reader->load($inputFileName);\n\n$helper->log($spreadsheet->getSheetCount() . ' worksheet' . (($spreadsheet->getSheetCount() == 1) ? '' : 's') . ' loaded');\n$loadedSheetNames = $spreadsheet->getSheetNames();\nforeach ($loadedSheetNames as $sheetIndex => $loadedSheetName) {\n $helper->log($sheetIndex . ' -> ' . $loadedSheetName);\n}\n"
},
{
"path": "samples/Reader/09_Simple_file_reader_using_a_read_filter.php",
"content": "= 9 && $row <= 15) {\n if (in_array($columnAddress, range('A', 'E'))) {\n return true;\n }\n }\n\n return false;\n }\n}\n\n$filterSubset = new MyReadFilter();\n\n$helper->log('Loading file ' . pathinfo($inputFileName, PATHINFO_BASENAME) . ' using IOFactory with a defined reader type of ' . $inputFileType);\n$helper->log('Filter range is A9:E15');\n$reader = IOFactory::createReader($inputFileType);\n$helper->log('Loading Sheet \"' . $sheetname . '\" only');\n$reader->setLoadSheetsOnly($sheetname);\n$helper->log('Loading Sheet using filter');\n$reader->setReadFilter($filterSubset);\n$spreadsheet = $reader->load($inputFileName);\n\n$activeRange = $spreadsheet->getActiveSheet()->calculateWorksheetDataDimension();\n$sheetData = $spreadsheet->getActiveSheet()->rangeToArray($activeRange, null, true, true, true);\n$helper->displayGrid($sheetData);\n"
},
{
"path": "samples/Reader/10_Simple_file_reader_using_a_configurable_read_filter.php",
"content": " $columns */\n public function __construct(\n private int $startRow,\n private int $endRow,\n private array $columns\n ) {\n }\n\n public function readCell(string $columnAddress, int $row, string $worksheetName = ''): bool\n {\n if ($row >= $this->startRow && $row <= $this->endRow) {\n if (in_array($columnAddress, $this->columns)) {\n return true;\n }\n }\n\n return false;\n }\n}\n\n$filterSubset = new MyReadFilter(9, 15, range('G', 'K'));\n\n$helper->log('Loading file ' . pathinfo($inputFileName, PATHINFO_BASENAME) . ' using IOFactory with a defined reader type of ' . $inputFileType);\n$helper->log('Filter range is G9:K15');\n$reader = IOFactory::createReader($inputFileType);\n$helper->log('Loading Sheet \"' . $sheetname . '\" only');\n$reader->setLoadSheetsOnly($sheetname);\n$helper->log('Loading Sheet using configurable filter');\n$reader->setReadFilter($filterSubset);\n$spreadsheet = $reader->load($inputFileName);\n\n$activeRange = $spreadsheet->getActiveSheet()->calculateWorksheetDataDimension();\n$sheetData = $spreadsheet->getActiveSheet()->rangeToArray($activeRange, null, true, true, true);\n$helper->displayGrid($sheetData);\n"
},
{
"path": "samples/Reader/11_Reading_a_workbook_in_chunks_using_a_configurable_read_filter_version_1.php",
"content": "startRow = $startRow;\n $this->endRow = $startRow + $chunkSize;\n }\n\n public function readCell(string $columnAddress, int $row, string $worksheetName = ''): bool\n {\n // Only read the heading row, and the rows that were configured in the constructor\n if (($row == 1) || ($row >= $this->startRow && $row < $this->endRow)) {\n return true;\n }\n\n return false;\n }\n}\n\n$helper->log('Loading file ' . pathinfo($inputFileName, PATHINFO_BASENAME) . ' using IOFactory with a defined reader type of ' . $inputFileType);\n// Create a new Reader of the type defined in $inputFileType\n$reader = IOFactory::createReader($inputFileType);\n\n// Define how many rows we want for each \"chunk\"\n$chunkSize = 20;\n\n// Loop to read our worksheet in \"chunk size\" blocks\nfor ($startRow = 2; $startRow <= 240; $startRow += $chunkSize) {\n $helper->log('Loading WorkSheet using configurable filter for headings row 1 and for rows ' . $startRow . ' to ' . ($startRow + $chunkSize - 1));\n // Create a new Instance of our Read Filter, passing in the limits on which rows we want to read\n $chunkFilter = new ChunkReadFilter($startRow, $chunkSize);\n // Tell the Reader that we want to use the new Read Filter that we've just Instantiated\n $reader->setReadFilter($chunkFilter);\n // Load only the rows that match our filter from $inputFileName to a PhpSpreadsheet Object\n $spreadsheet = $reader->load($inputFileName);\n $sheet = $spreadsheet->getActiveSheet();\n\n // Do some processing here\n\n $activeRange = $sheet->calculateWorksheetDataDimension();\n $sheet->getStyle($activeRange)->getNumberFormat()\n ->setFormatCode('0.000');\n $sheetData = $sheet->rangeToArray($activeRange, null, true, true, true);\n $helper->displayGrid($sheetData, true);\n}\n"
},
{
"path": "samples/Reader/12_Reading_a_workbook_in_chunks_using_a_configurable_read_filter_version_2.php",
"content": "startRow = $startRow;\n $this->endRow = $startRow + $chunkSize;\n }\n\n public function readCell(string $columnAddress, int $row, string $worksheetName = ''): bool\n {\n // Only read the heading row, and the rows that are configured in $this->_startRow and $this->_endRow\n if (($row == 1) || ($row >= $this->startRow && $row < $this->endRow)) {\n return true;\n }\n\n return false;\n }\n}\n\n$helper->log('Loading file ' . pathinfo($inputFileName, PATHINFO_BASENAME) . ' using IOFactory with a defined reader type of ' . $inputFileType);\n// Create a new Reader of the type defined in $inputFileType\n$reader = IOFactory::createReader($inputFileType);\n\n// Define how many rows we want to read for each \"chunk\"\n$chunkSize = 20;\n// Create a new Instance of our Read Filter\n$chunkFilter = new ChunkReadFilter();\n\n// Tell the Reader that we want to use the Read Filter that we've Instantiated\n$reader->setReadFilter($chunkFilter);\n\n// Loop to read our worksheet in \"chunk size\" blocks\nfor ($startRow = 2; $startRow <= 240; $startRow += $chunkSize) {\n $helper->log('Loading WorkSheet using configurable filter for headings row 1 and for rows ' . $startRow . ' to ' . ($startRow + $chunkSize - 1));\n // Tell the Read Filter, the limits on which rows we want to read this iteration\n $chunkFilter->setRows($startRow, $chunkSize);\n // Load only the rows that match our filter from $inputFileName to a PhpSpreadsheet Object\n $spreadsheet = $reader->load($inputFileName);\n $sheet = $spreadsheet->getActiveSheet();\n\n // Do some processing here\n\n $activeRange = $sheet->calculateWorksheetDataDimension();\n $sheet->getStyle($activeRange)->getNumberFormat()\n ->setFormatCode('0.000');\n $sheetData = $sheet->rangeToArray($activeRange, null, true, true, true);\n $helper->displayGrid($sheetData, true);\n}\n"
},
{
"path": "samples/Reader2/13_Simple_file_reader_for_multiple_CSV_files.php",
"content": "log('Loading file ' . pathinfo($inputFileName, PATHINFO_BASENAME) . ' into WorkSheet #1 using Csv Reader');\n$spreadsheet = $reader->load($inputFileName);\n$spreadsheet->getActiveSheet()->setTitle(pathinfo($inputFileName, PATHINFO_BASENAME));\nforeach ($inputFileNames as $sheet => $inputFileName) {\n $helper->log('Loading file ' . pathinfo($inputFileName, PATHINFO_BASENAME) . ' into WorkSheet #' . ($sheet + 2) . ' using Csv Reader');\n $reader->setSheetIndex($sheet + 1);\n $reader->loadIntoExisting($inputFileName, $spreadsheet);\n $spreadsheet->getActiveSheet()->setTitle(pathinfo($inputFileName, PATHINFO_BASENAME));\n}\n\n$helper->log($spreadsheet->getSheetCount() . ' worksheet' . (($spreadsheet->getSheetCount() == 1) ? '' : 's') . ' loaded');\n$loadedSheetNames = $spreadsheet->getSheetNames();\nforeach ($loadedSheetNames as $sheetIndex => $loadedSheetName) {\n $helper->log('Worksheet #' . $sheetIndex . ' -> ' . $loadedSheetName . '');\n $spreadsheet->setActiveSheetIndexByName($loadedSheetName);\n $sheet = $spreadsheet->getActiveSheet();\n\n $activeRange = $sheet->calculateWorksheetDataDimension();\n $sheet->getStyle($activeRange)->getNumberFormat()\n ->setFormatCode('0.000');\n $sheetData = $sheet->rangeToArray($activeRange, null, true, true, true);\n $helper->displayGrid($sheetData, true);\n}\n"
},
{
"path": "samples/Reader2/14_Reading_a_large_CSV_file_in_chunks_to_split_across_multiple_worksheets.php",
"content": "startRow = $startRow;\n $this->endRow = $startRow + $chunkSize;\n }\n\n public function readCell(string $columnAddress, int $row, string $worksheetName = ''): bool\n {\n // Only read the heading row, and the rows that are configured in $this->_startRow and $this->_endRow\n if (($row == 1) || ($row >= $this->startRow && $row < $this->endRow)) {\n return true;\n }\n\n return false;\n }\n}\n\n$helper->log('Loading file ' . pathinfo($inputFileName, PATHINFO_BASENAME) . ' using Csv reader');\n// Create a new Reader of the type defined in $inputFileType\n$reader = new Csv();\n\n// Define how many rows we want to read for each \"chunk\"\n$chunkSize = 100;\n// Create a new Instance of our Read Filter\n$chunkFilter = new ChunkReadFilter();\n\n// Tell the Reader that we want to use the Read Filter that we've Instantiated\n// and that we want to store it in contiguous rows/columns\n$reader->setReadFilter($chunkFilter);\n$reader->setContiguous(true);\n\n// Instantiate a new PhpSpreadsheet object manually\n$spreadsheet = new Spreadsheet();\n\n// Set a sheet index\n$sheet = 0;\n// Loop to read our worksheet in \"chunk size\" blocks\n/** $startRow is set to 2 initially because we always read the headings in row #1 * */\nfor ($startRow = 2; $startRow <= 240; $startRow += $chunkSize) {\n $helper->log('Loading WorkSheet #' . ($sheet + 1) . ' using configurable filter for headings row 1 and for rows ' . $startRow . ' to ' . ($startRow + $chunkSize - 1));\n // Tell the Read Filter, the limits on which rows we want to read this iteration\n $chunkFilter->setRows($startRow, $chunkSize);\n\n // Increment the worksheet index pointer for the Reader\n $reader->setSheetIndex($sheet);\n // Load only the rows that match our filter into a new worksheet in the PhpSpreadsheet Object\n $reader->loadIntoExisting($inputFileName, $spreadsheet);\n // Set the worksheet title (to reference the \"sheet\" of data that we've loaded)\n // and increment the sheet index as well\n $spreadsheet->getActiveSheet()->setTitle('Country Data #' . (++$sheet));\n}\n\n$helper->log($spreadsheet->getSheetCount() . ' worksheet' . (($spreadsheet->getSheetCount() == 1) ? '' : 's') . ' loaded');\n$loadedSheetNames = $spreadsheet->getSheetNames();\nforeach ($loadedSheetNames as $sheetIndex => $loadedSheetName) {\n $helper->log('Worksheet #' . $sheetIndex . ' -> ' . $loadedSheetName . '');\n $spreadsheet->setActiveSheetIndexByName($loadedSheetName);\n $sheet = $spreadsheet->getActiveSheet();\n\n $activeRange = $sheet->calculateWorksheetDataDimension();\n $sheet->getStyle($activeRange)->getNumberFormat()\n ->setFormatCode('0.000');\n $sheetData = $sheet->rangeToArray($activeRange, null, true, true, true);\n $helper->displayGrid($sheetData, true);\n}\n"
},
{
"path": "samples/Reader2/15_Simple_file_reader_for_tab_separated_value_file_using_the_Advanced_Value_Binder.php",
"content": "log('Loading file ' . pathinfo($inputFileName, PATHINFO_BASENAME) . ' into WorkSheet #1 using Csv reader');\n$reader->setDelimiter(\"\\t\");\n$spreadsheet = $reader->load($inputFileName);\n$spreadsheet->getActiveSheet()->setTitle(pathinfo($inputFileName, PATHINFO_BASENAME));\n\n$helper->log($spreadsheet->getSheetCount() . ' worksheet' . (($spreadsheet->getSheetCount() == 1) ? '' : 's') . ' loaded');\n$loadedSheetNames = $spreadsheet->getSheetNames();\nforeach ($loadedSheetNames as $sheetIndex => $loadedSheetName) {\n $helper->log('Worksheet #' . $sheetIndex . ' -> ' . $loadedSheetName . ' (Formatted)');\n $spreadsheet->setActiveSheetIndexByName($loadedSheetName);\n\n $activeRange = $spreadsheet->getActiveSheet()->calculateWorksheetDataDimension();\n $sheetData = $spreadsheet->getActiveSheet()->rangeToArray($activeRange, null, true, true, true);\n $helper->displayGrid($sheetData);\n}\n\nforeach ($loadedSheetNames as $sheetIndex => $loadedSheetName) {\n $helper->log('Worksheet #' . $sheetIndex . ' -> ' . $loadedSheetName . ' (Unformatted)');\n $spreadsheet->setActiveSheetIndexByName($loadedSheetName);\n\n $activeRange = $spreadsheet->getActiveSheet()->calculateWorksheetDataDimension();\n $sheetData = $spreadsheet->getActiveSheet()->rangeToArray($activeRange, null, true, true, true);\n $helper->displayGrid($sheetData);\n}\n\nforeach ($loadedSheetNames as $sheetIndex => $loadedSheetName) {\n $helper->log('Worksheet #' . $sheetIndex . ' -> ' . $loadedSheetName . ' (Raw)');\n $spreadsheet->setActiveSheetIndexByName($loadedSheetName);\n\n $activeRange = $spreadsheet->getActiveSheet()->calculateWorksheetDataDimension();\n $sheetData = $spreadsheet->getActiveSheet()->rangeToArray($activeRange, null, true, true, true);\n $helper->displayGrid($sheetData);\n}\n"
},
{
"path": "samples/Reader2/16_Handling_loader_exceptions_using_TryCatch.php",
"content": "log('Loading file ' . pathinfo($inputFileName, PATHINFO_BASENAME) . ' using IOFactory to identify the format');\n\ntry {\n $spreadsheet = IOFactory::load($inputFileName);\n} catch (ReaderException $e) {\n $helper->log('Error loading file \"' . pathinfo($inputFileName, PATHINFO_BASENAME) . '\": ' . $e->getMessage());\n}\n"
},
{
"path": "samples/Reader2/17_Simple_file_reader_loading_several_named_worksheets.php",
"content": "log('Loading file ' . pathinfo($inputFileName, PATHINFO_BASENAME) . ' using Xls reader');\n$reader = new Xls();\n\n// Read the list of Worksheet Names from the Workbook file\n$helper->log('Read the list of Worksheets in the WorkBook');\n$worksheetNames = $reader->listWorksheetNames($inputFileName);\n\n$helper->log('There are ' . count($worksheetNames) . ' worksheet' . ((count($worksheetNames) == 1) ? '' : 's') . ' in the workbook');\nforeach ($worksheetNames as $worksheetName) {\n $helper->log($worksheetName);\n}\n"
},
{
"path": "samples/Reader2/18_Reading_list_of_worksheets_without_loading_entire_file.php",
"content": "log('Loading file ' . pathinfo($inputFileName, PATHINFO_BASENAME) . ' information using Xls reader');\n\n$reader = new Xls();\n$worksheetNames = $reader->listWorksheetNames($inputFileName);\n\n$helper->log('
Code:
');\n $helper->log('use PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard;');\n $helper->log(\n \"\\$wizard = new Wizard\\\\Accounting('{$_POST['currency']}', {$_POST['decimals']}, Wizard\\\\Number::\"\n . (isset($_POST['thousands']) ? 'WITH_THOUSANDS_SEPARATOR' : 'WITHOUT_THOUSANDS_SEPARATOR')\n . ', Wizard\\Currency::' . (((bool) $_POST['position']) ? 'LEADING_SYMBOL' : 'TRAILING_SYMBOL')\n . ');'\n );\n $helper->log('$mask = $wizard->format();');\n $helper->log('
echo (string) $mask;');\n $helper->log('
Mask:
');\n $helper->log($mask . '
');\n $helper->log('
Example:
');\n $helper->log($example);\n } catch (SpreadsheetException $e) {\n $helper->log(\"Exception: {$e->getMessage()}\");\n }\n }\n}\n" }, { "path": "samples/Wizards/NumberFormat/Currency.php", "content": "isCli()) {\n $helper->log('This example should only be run from a Web Browser' . PHP_EOL);\n\n return;\n}\n\n$negatives = [\n CurrencyNegative::minus,\n CurrencyNegative::redMinus,\n CurrencyNegative::parentheses,\n CurrencyNegative::redParentheses,\n];\n$negativesString = [\n 'CurrencyNegative::minus',\n 'CurrencyNegative::redMinus',\n 'CurrencyNegative::parentheses',\n 'CurrencyNegative::redParentheses',\n];\n\n$currencies = [\n '$' => 'US Dollars ($)',\n '€' => 'Euro (€)',\n '¥' => 'Japanese Yen (¥)',\n '£' => 'Pound Sterling (£)',\n '₹' => 'Rupee (₹)',\n '₽' => 'Rouble (₽)',\n];\n\n$postNegative = StringHelper::convertPostToString('negative');\nif (!in_array($postNegative, ['0', '1', '2', '3'], true)) {\n $postNegative = '0';\n}\n$postNegative = (int) $postNegative;\n?>\n \n\nlog('The Sample Number Value must be numeric');\n } elseif (!is_numeric($_POST['decimals']) || str_contains((string) $_POST['decimals'], '.') || (int) $_POST['decimals'] < 0) {\n $helper->log('The Decimal Places value must be positive integer');\n } elseif (!in_array($_POST['currency'], array_keys($currencies), true)) {\n $helper->log('Unrecognized currency symbol');\n } else {\n try {\n $negative = $negatives[$postNegative];\n $wizard = new Wizard\\Currency($_POST['currency'], (int) $_POST['decimals'], isset($_POST['thousands']), (bool) $_POST['position']);\n $wizard->setNegative($negative);\n $mask = $wizard->format();\n $example = (string) NumberFormat::toFormattedString((float) $_POST['number'], $mask, [HtmlWriter::class, 'formatColorStatic']);\n $helper->log('
Code:
');\n $helper->log('use PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard;');\n $helper->log('use PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\CurrencyNegative;');\n $helper->log(\n \"\\$wizard = new Wizard\\\\Currency('{$_POST['currency']}', {$_POST['decimals']}, Wizard\\\\Number::\"\n . (isset($_POST['thousands']) ? 'WITH_THOUSANDS_SEPARATOR' : 'WITHOUT_THOUSANDS_SEPARATOR')\n . ', Wizard\\Currency::' . (((bool) $_POST['position']) ? 'LEADING_SYMBOL' : 'TRAILING_SYMBOL')\n . ');'\n );\n $helper->log('$wizard->setNegative(' . $negativesString[$postNegative] . ');');\n $helper->log('$mask = $wizard->format();');\n $helper->log('
echo (string) $mask;');\n $helper->log('
Mask:
');\n $helper->log($mask . '
');\n $helper->log('
Example:
');\n $helper->log($example);\n } catch (SpreadsheetException $e) {\n $helper->log(\"Exception: {$e->getMessage()}\");\n }\n }\n}\n" }, { "path": "samples/Wizards/NumberFormat/Number.php", "content": "isCli()) {\n $helper->log('This example should only be run from a Web Browser' . PHP_EOL);\n\n return;\n}\n?>\n \n\nlog('The Sample Number Value must be numeric');\n } elseif (!is_numeric($_POST['decimals']) || str_contains((string) $_POST['decimals'], '.') || (int) $_POST['decimals'] < 0) {\n $helper->log('The Decimal Places value must be positive integer');\n } else {\n try {\n $wizard = new Wizard\\Number((int) $_POST['decimals'], isset($_POST['thousands']));\n $mask = $wizard->format();\n $example = NumberFormat::toFormattedString((float) $_POST['number'], $mask);\n $helper->log('
Code:
');\n $helper->log('use PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard;');\n $helper->log(\n \"\\$mask = Wizard\\\\Number({$_POST['decimals']}, Wizard\\\\Number::\"\n . (isset($_POST['thousands']) ? 'WITH_THOUSANDS_SEPARATOR' : 'WITHOUT_THOUSANDS_SEPARATOR')\n . ');
'\n );\n $helper->log('echo (string) $mask;');\n $helper->log('
Mask:');\n $helper->log($mask);\n $helper->log('Example:');\n $helper->log($example);\n } catch (SpreadsheetException $e) {\n $helper->log(\"Exception: {$e->getMessage()}\");\n }\n }\n}\n" }, { "path": "samples/Wizards/NumberFormat/Percentage.php", "content": "isCli()) {\n $helper->log('This example should only be run from a Web Browser' . PHP_EOL);\n\n return;\n}\n?>\n \n\nlog('The Sample Number Value must be numeric');\n } elseif (!is_numeric($_POST['decimals']) || str_contains((string) $_POST['decimals'], '.') || (int) $_POST['decimals'] < 0) {\n $helper->log('The Decimal Places value must be positive integer');\n } else {\n try {\n $wizard = new Wizard\\Percentage((int) $_POST['decimals']);\n $mask = $wizard->format();\n $example = (string) NumberFormat::toFormattedString((float) $_POST['number'], $mask);\n $helper->log('
Code:
');\n $helper->log('use PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard;');\n $helper->log(\"\\$mask = Wizard\\\\Percentage({$_POST['decimals']});
\");\n $helper->log('echo (string) $mask;');\n $helper->log('
Mask:
');\n $helper->log($mask . '
');\n $helper->log('
Example:
');\n $helper->log($example);\n } catch (SpreadsheetException $e) {\n $helper->log(\"Exception: {$e->getMessage()}\");\n }\n }\n}\n" }, { "path": "samples/Wizards/NumberFormat/Scientific.php", "content": "isCli()) {\n $helper->log('This example should only be run from a Web Browser' . PHP_EOL);\n\n return;\n}\n?>\n \n\nlog('The Sample Number Value must be numeric');\n } elseif (!is_numeric($_POST['decimals']) || str_contains((string) $_POST['decimals'], '.') || (int) $_POST['decimals'] < 0) {\n $helper->log('The Decimal Places value must be positive integer');\n } else {\n try {\n $wizard = new Wizard\\Scientific((int) $_POST['decimals']);\n $mask = $wizard->format();\n $example = (string) NumberFormat::toFormattedString((float) $_POST['number'], $mask);\n $helper->log('
Code:
');\n $helper->log('use PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard;');\n $helper->log(\"\\$mask = Wizard\\\\Scientific({$_POST['decimals']});
\");\n $helper->log('echo (string) $mask;');\n $helper->log('
Mask:
');\n $helper->log($mask . '
');\n $helper->log('
Example:
');\n $helper->log($example);\n } catch (SpreadsheetException $e) {\n $helper->log(\"Exception: {$e->getMessage()}\");\n }\n }\n}\n" }, { "path": "samples/bootstrap/css/phpspreadsheet.css", "content": "body {\n padding-top: 20px;\n padding-bottom: 20px;\n}\n.navbar {\n margin-bottom: 20px;\n}\n.navbar + h1 {\n margin-top: 70px;\n}\n.passed {\n color: #339900;\n}\n.failed {\n color: #ff0000;\n}" }, { "path": "samples/download.php", "content": "getTemporaryFolder(), $filename, $filetype);\n $downloader->download();\n} catch (Exception $e) {\n exit($e->getMessage());\n}\n" }, { "path": "samples/index.php", "content": " version_compare(PHP_VERSION, '8.1', '>='),\n 'PHP extension XML' => extension_loaded('xml'),\n 'PHP extension xmlwriter' => extension_loaded('xmlwriter'),\n 'PHP extension mbstring' => extension_loaded('mbstring'),\n 'PHP extension ZipArchive' => extension_loaded('zip'),\n 'PHP extension GD (optional)' => extension_loaded('gd'),\n 'PHP extension dom (optional)' => extension_loaded('dom'),\n];\n\n/** @var PhpOffice\\PhpSpreadsheet\\Helper\\Sample $helper */\nif (!$helper->isCli()) {\n ?>\nCompetency List \n\n\n\n
\n\n\n"
},
{
"path": "samples/templates/Excel2003XMLTest.xml",
"content": "\n \n \n \n 3 \n #000000 \n \n \n 4 \n #0000ff \n \n \n 5 \n #008000 \n \n \n 6 \n #00ccff \n \n \n 7 \n #800080 \n \n \n 8 \n #993366 \n \n \n 9 \n #c0c0c0 \n \n \n 10 \n #c47512 \n \n \n 11 \n #ccffcc \n \n \n 12 \n #ddbc7d \n \n \n 13 \n #ff0000 \n \n \n 14 \n #ff00ff \n \n \n 15 \n #ff6600 \n \n \n 16 \n #ff9900 \n \n \n 17 \n #ff99cc \n \n \n 18 \n #ffff00 \n \n \n \n \n 9000 \n 13860 \n 240 \n 75 \n False \n False \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
\n \n \n"
},
{
"path": "samples/templates/excel2003.xml",
"content": "\r\n\r\n\r\n \r\n Xml2003 Workbook \r\n Test Gnumeric Workbook Subject \r\n Mark Baker \r\n PHPExcel Xml Reader Test Keywords \r\n Some comments about the PHPExcel Gnumeric Reader \r\n Owen Leibman \r\n 2010-09-02T20:48:39Z \r\n 2010-09-03T21:48:39Z \r\n PHPExcel Xml Reader Test Category \r\n Maarten Balliauw \r\n PHPExcel \r\n https://github.com/PHPOffice/PhpSpreadsheet \r\n 16.00 \r\n \r\n \r\n AbCd1234 \r\n 2019-01-31T07:00:00Z \r\n 1 \r\n 3 \r\n 2 \r\n 3.14159 \r\n \r\n \r\n \r\n \r\n 8964 \r\n 23040 \r\n 32767 \r\n 32767 \r\n False \r\n False \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n
\r\n \r\n \r\n \r\n \r\n \r\n 600 \r\n 600 \r\n \r\n 3 \r\n \r\n \r\n 3 \r\n 18 \r\n 10 \r\n \r\n \r\n False \r\n False \r\n \r\n \r\n \r\n \r\n
\r\n \r\n \r\n \r\n \r\n \r\n 600 \r\n 600 \r\n \r\n \r\n \r\n 3 \r\n 8 \r\n R1C9:R15C11 \r\n \r\n \r\n False \r\n False \r\n \r\n \r\n \r\n"
},
{
"path": "samples/templates/largeSpreadsheet.php",
"content": "log('Create new Spreadsheet object');\n$spreadsheet = new Spreadsheet();\n\n// Set document properties\n$helper->log('Set properties');\n$spreadsheet->getProperties()->setCreator('Maarten Balliauw')\n ->setLastModifiedBy('Maarten Balliauw')\n ->setTitle('Office 2007 XLSX Test Document')\n ->setSubject('Office 2007 XLSX Test Document')\n ->setDescription('Test document for Office 2007 XLSX, generated using PHP classes.')\n ->setKeywords('office 2007 openxml php')\n ->setCategory('Test result file');\n\n// Create a first sheet\n$helper->log('Add data');\n$spreadsheet->setActiveSheetIndex(0);\n$spreadsheet->getActiveSheet()->setCellValue('A1', 'Firstname');\n$spreadsheet->getActiveSheet()->setCellValue('B1', 'Lastname');\n$spreadsheet->getActiveSheet()->setCellValue('C1', 'Phone');\n$spreadsheet->getActiveSheet()->setCellValue('D1', 'Fax');\n$spreadsheet->getActiveSheet()->setCellValue('E1', 'Is Client ?');\n\n// Hide \"Phone\" and \"fax\" column\n$helper->log(\"Hide 'Phone' and 'fax' columns\");\n$spreadsheet->getActiveSheet()->getColumnDimension('C')->setVisible(false);\n$spreadsheet->getActiveSheet()->getColumnDimension('D')->setVisible(false);\n\n// Set outline levels\n$helper->log('Set outline levels');\n$spreadsheet->getActiveSheet()->getColumnDimension('E')->setOutlineLevel(1)\n ->setVisible(false)\n ->setCollapsed(true);\n\n// Freeze panes\n$helper->log('Freeze panes');\n$spreadsheet->getActiveSheet()->freezePane('A2');\n\n// Rows to repeat at top\n$helper->log('Rows to repeat at top');\n$spreadsheet->getActiveSheet()->getPageSetup()->setRowsToRepeatAtTopByStartAndEnd(1, 1);\n\n// Add data\nfor ($i = 2; $i <= 5000; ++$i) {\n $spreadsheet->getActiveSheet()->setCellValue('A' . $i, \"FName $i\")\n ->setCellValue('B' . $i, \"LName $i\")\n ->setCellValue('C' . $i, \"PhoneNo $i\")\n ->setCellValue('D' . $i, \"FaxNo $i\")\n ->setCellValue('E' . $i, true);\n}\n\nreturn $spreadsheet;\n"
},
{
"path": "samples/templates/sampleSpreadsheet.php",
"content": "log('Create new Spreadsheet object');\n$spreadsheet = new Spreadsheet();\n\n// Set document properties\n$helper->log('Set document properties');\n$spreadsheet->getProperties()->setCreator('Maarten Balliauw')\n ->setLastModifiedBy('Maarten Balliauw')\n ->setTitle('Office 2007 XLSX Test Document')\n ->setSubject('Office 2007 XLSX Test Document')\n ->setDescription('Test document for Office 2007 XLSX, generated using PHP classes.')\n ->setKeywords('office 2007 openxml php')\n ->setCategory('Test result file');\n\n// Create a first sheet, representing sales data\n$helper->log('Add some data');\n$spreadsheet->setActiveSheetIndex(0);\n$spreadsheet->getActiveSheet()->setCellValue('B1', 'Invoice');\n$date = new DateTime('now');\n$date->setTime(0, 0, 0);\n$spreadsheet->getActiveSheet()->setCellValue('D1', Date::PHPToExcel($date));\n$spreadsheet->getActiveSheet()->getStyle('D1')->getNumberFormat()->setFormatCode(NumberFormat::FORMAT_DATE_XLSX15);\n$spreadsheet->getActiveSheet()->setCellValue('E1', '#12566');\n\n$spreadsheet->getActiveSheet()->setCellValue('A3', 'Product Id');\n$spreadsheet->getActiveSheet()->setCellValue('B3', 'Description');\n$spreadsheet->getActiveSheet()->setCellValue('C3', 'Price');\n$spreadsheet->getActiveSheet()->setCellValue('D3', 'Amount');\n$spreadsheet->getActiveSheet()->setCellValue('E3', 'Total');\n\n$spreadsheet->getActiveSheet()->setCellValue('A4', '1001');\n$spreadsheet->getActiveSheet()->setCellValue('B4', 'PHP for dummies');\n$spreadsheet->getActiveSheet()->setCellValue('C4', '20');\n$spreadsheet->getActiveSheet()->setCellValue('D4', '1');\n$spreadsheet->getActiveSheet()->setCellValue('E4', '=IF(D4<>\"\",C4*D4,\"\")');\n\n$spreadsheet->getActiveSheet()->setCellValue('A5', '1012');\n$spreadsheet->getActiveSheet()->setCellValue('B5', 'OpenXML for dummies');\n$spreadsheet->getActiveSheet()->setCellValue('C5', '22');\n$spreadsheet->getActiveSheet()->setCellValue('D5', '2');\n$spreadsheet->getActiveSheet()->setCellValue('E5', '=IF(D5<>\"\",C5*D5,\"\")');\n\n$spreadsheet->getActiveSheet()->setCellValue('E6', '=IF(D6<>\"\",C6*D6,\"\")');\n$spreadsheet->getActiveSheet()->setCellValue('E7', '=IF(D7<>\"\",C7*D7,\"\")');\n$spreadsheet->getActiveSheet()->setCellValue('E8', '=IF(D8<>\"\",C8*D8,\"\")');\n$spreadsheet->getActiveSheet()->setCellValue('E9', '=IF(D9<>\"\",C9*D9,\"\")');\n\n$spreadsheet->getActiveSheet()->setCellValue('D11', 'Total excl.:');\n$spreadsheet->getActiveSheet()->setCellValue('E11', '=SUM(E4:E9)');\n\n$spreadsheet->getActiveSheet()->setCellValue('D12', 'VAT:');\n$spreadsheet->getActiveSheet()->setCellValue('E12', '=E11*0.21');\n\n$spreadsheet->getActiveSheet()->setCellValue('D13', 'Total incl.:');\n$spreadsheet->getActiveSheet()->setCellValue('E13', '=E11+E12');\n\n// Add comment\n$helper->log('Add comments');\n\n$spreadsheet->getActiveSheet()->getComment('E11')->setAuthor('PhpSpreadsheet');\n$commentRichText = $spreadsheet->getActiveSheet()->getComment('E11')->getText()->createTextRun('PhpSpreadsheet:');\n$commentRichText->getFontOrThrow()->setBold(true);\n$spreadsheet->getActiveSheet()->getComment('E11')->getText()->createTextRun(\"\\r\\n\");\n$spreadsheet->getActiveSheet()->getComment('E11')->getText()->createTextRun('Total amount on the current invoice, excluding VAT.');\n\n$spreadsheet->getActiveSheet()->getComment('E12')->setAuthor('PhpSpreadsheet');\n$commentRichText = $spreadsheet->getActiveSheet()->getComment('E12')->getText()->createTextRun('PhpSpreadsheet:');\n$commentRichText->getFontOrThrow()->setBold(true);\n$spreadsheet->getActiveSheet()->getComment('E12')->getText()->createTextRun(\"\\r\\n\");\n$spreadsheet->getActiveSheet()->getComment('E12')->getText()->createTextRun('Total amount of VAT on the current invoice.');\n\n$spreadsheet->getActiveSheet()->getComment('E13')->setAuthor('PhpSpreadsheet');\n$commentRichText = $spreadsheet->getActiveSheet()->getComment('E13')->getText()->createTextRun('PhpSpreadsheet:');\n$commentRichText->getFontOrThrow()->setBold(true);\n$spreadsheet->getActiveSheet()->getComment('E13')->getText()->createTextRun(\"\\r\\n\");\n$spreadsheet->getActiveSheet()->getComment('E13')->getText()->createTextRun('Total amount on the current invoice, including VAT.');\n$spreadsheet->getActiveSheet()->getComment('E13')->setWidth('100pt');\n$spreadsheet->getActiveSheet()->getComment('E13')->setHeight('100pt');\n$spreadsheet->getActiveSheet()->getComment('E13')->setMarginLeft('150pt');\n$spreadsheet->getActiveSheet()->getComment('E13')->getFillColor()->setRGB('EEEEEE');\n\n// Add rich-text string\n$helper->log('Add rich-text string');\n$richText = new RichText();\n$richText->createText('This invoice is ');\n\n$payable = $richText->createTextRun('payable within thirty days after the end of the month');\n$payable->getFontOrThrow()->setBold(true);\n$payable->getFontOrThrow()->setItalic(true);\n$payable->getFontOrThrow()->setColor(new Color(Color::COLOR_DARKGREEN));\n\n$richText->createText(', unless specified otherwise on the invoice.');\n\n$spreadsheet->getActiveSheet()->getCell('A18')->setValue($richText);\n\n// Merge cells\n$helper->log('Merge cells');\n$spreadsheet->getActiveSheet()->mergeCells('A18:E22');\n$spreadsheet->getActiveSheet()->mergeCells('A28:B28'); // Just to test...\n$spreadsheet->getActiveSheet()->unmergeCells('A28:B28'); // Just to test...\n// Protect cells\n$helper->log('Protect cells');\n$spreadsheet->getActiveSheet()->getProtection()->setSheet(true); // Needs to be set to true in order to enable any worksheet protection!\n$spreadsheet->getActiveSheet()->protectCells('A3:E13', 'PhpSpreadsheet');\n\n// Set cell number formats\n$helper->log('Set cell number formats');\n$spreadsheet->getActiveSheet()->getStyle('E4:E13')->getNumberFormat()->setFormatCode(NumberFormat::FORMAT_CURRENCY_EUR_INTEGER);\n\n// Set column widths\n$helper->log('Set column widths');\n$spreadsheet->getActiveSheet()->getColumnDimension('B')->setAutoSize(true);\n$spreadsheet->getActiveSheet()->getColumnDimension('D')->setWidth(12);\n$spreadsheet->getActiveSheet()->getColumnDimension('E')->setWidth(12);\n\n// Set fonts\n$helper->log('Set fonts');\n$spreadsheet->getActiveSheet()->getStyle('B1')->getFont()->setName('Candara');\n$spreadsheet->getActiveSheet()->getStyle('B1')->getFont()->setSize(20);\n$spreadsheet->getActiveSheet()->getStyle('B1')->getFont()->setBold(true);\n$spreadsheet->getActiveSheet()->getStyle('B1')->getFont()->setUnderline(Font::UNDERLINE_SINGLE);\n$spreadsheet->getActiveSheet()->getStyle('B1')->getFont()->getColor()->setARGB(Color::COLOR_WHITE);\n\n$spreadsheet->getActiveSheet()->getStyle('D1')->getFont()->getColor()->setARGB(Color::COLOR_WHITE);\n$spreadsheet->getActiveSheet()->getStyle('E1')->getFont()->getColor()->setARGB(Color::COLOR_WHITE);\n\n$spreadsheet->getActiveSheet()->getStyle('D13')->getFont()->setBold(true);\n$spreadsheet->getActiveSheet()->getStyle('E13')->getFont()->setBold(true);\n\n// Set alignments\n$helper->log('Set alignments');\n$spreadsheet->getActiveSheet()->getStyle('D11')->getAlignment()->setHorizontal(Alignment::HORIZONTAL_RIGHT);\n$spreadsheet->getActiveSheet()->getStyle('D12')->getAlignment()->setHorizontal(Alignment::HORIZONTAL_RIGHT);\n$spreadsheet->getActiveSheet()->getStyle('D13')->getAlignment()->setHorizontal(Alignment::HORIZONTAL_RIGHT);\n\n$spreadsheet->getActiveSheet()->getStyle('A18')->getAlignment()->setHorizontal(Alignment::HORIZONTAL_JUSTIFY);\n$spreadsheet->getActiveSheet()->getStyle('A18')->getAlignment()->setVertical(Alignment::VERTICAL_CENTER);\n\n$spreadsheet->getActiveSheet()->getStyle('B5')->getAlignment()->setShrinkToFit(true);\n\n// Set thin black border outline around column\n$helper->log('Set thin black border outline around column');\n$styleThinBlackBorderOutline = [\n 'borders' => [\n 'outline' => [\n 'borderStyle' => Border::BORDER_THIN,\n 'color' => ['argb' => 'FF000000'],\n ],\n ],\n];\n$spreadsheet->getActiveSheet()->getStyle('A4:E10')->applyFromArray($styleThinBlackBorderOutline);\n\n// Set thick brown border outline around \"Total\"\n$helper->log('Set thick brown border outline around Total');\n$styleThickBrownBorderOutline = [\n 'borders' => [\n 'outline' => [\n 'borderStyle' => Border::BORDER_THICK,\n 'color' => ['argb' => 'FF993300'],\n ],\n ],\n];\n$spreadsheet->getActiveSheet()->getStyle('D13:E13')->applyFromArray($styleThickBrownBorderOutline);\n\n// Set fills\n$helper->log('Set fills');\n$spreadsheet->getActiveSheet()->getStyle('A1:E1')->getFill()->setFillType(Fill::FILL_SOLID);\n$spreadsheet->getActiveSheet()->getStyle('A1:E1')->getFill()->getStartColor()->setARGB('FF808080');\n\n// Set style for header row using alternative method\n$helper->log('Set style for header row using alternative method');\n$spreadsheet->getActiveSheet()->getStyle('A3:E3')->applyFromArray(\n [\n 'font' => [\n 'bold' => true,\n ],\n 'alignment' => [\n 'horizontal' => Alignment::HORIZONTAL_RIGHT,\n ],\n 'borders' => [\n 'top' => [\n 'borderStyle' => Border::BORDER_THIN,\n ],\n ],\n 'fill' => [\n 'fillType' => Fill::FILL_GRADIENT_LINEAR,\n 'rotation' => 90,\n 'startColor' => [\n 'argb' => 'FFA0A0A0',\n ],\n 'endColor' => [\n 'argb' => 'FFFFFFFF',\n ],\n ],\n ]\n);\n\n$spreadsheet->getActiveSheet()->getStyle('A3')->applyFromArray(\n [\n 'alignment' => [\n 'horizontal' => Alignment::HORIZONTAL_LEFT,\n ],\n 'borders' => [\n 'left' => [\n 'borderStyle' => Border::BORDER_THIN,\n ],\n ],\n ]\n);\n\n$spreadsheet->getActiveSheet()->getStyle('B3')->applyFromArray(\n [\n 'alignment' => [\n 'horizontal' => Alignment::HORIZONTAL_LEFT,\n ],\n ]\n);\n\n$spreadsheet->getActiveSheet()->getStyle('E3')->applyFromArray(\n [\n 'borders' => [\n 'right' => [\n 'borderStyle' => Border::BORDER_THIN,\n ],\n ],\n ]\n);\n\n// Unprotect a cell\n$helper->log('Unprotect a cell');\n$spreadsheet->getActiveSheet()->getStyle('B1')->getProtection()->setLocked(Protection::PROTECTION_UNPROTECTED);\n\n// Add a hyperlink to the sheet\n$helper->log('Add a hyperlink to an external website');\n$spreadsheet->getActiveSheet()->setCellValue('E26', 'www.example.com');\n$spreadsheet->getActiveSheet()->getCell('E26')->getHyperlink()->setUrl('https://www.example.com');\n$spreadsheet->getActiveSheet()->getCell('E26')->getHyperlink()->setTooltip('Navigate to website');\n$spreadsheet->getActiveSheet()->getStyle('E26')->getAlignment()->setHorizontal(Alignment::HORIZONTAL_RIGHT);\n$spreadsheet->getActiveSheet()->getStyle('E26')->getFont()->setHyperlinkTheme();\n\n$helper->log('Add a hyperlink to another cell on a different worksheet within the workbook');\n$spreadsheet->getActiveSheet()->setCellValue('E27', 'Terms and conditions');\n$spreadsheet->getActiveSheet()->getCell('E27')->getHyperlink()->setUrl(\"sheet://'Terms and conditions'!A1\");\n$spreadsheet->getActiveSheet()->getCell('E27')->getHyperlink()->setTooltip('Review terms and conditions');\n$spreadsheet->getActiveSheet()->getStyle('E27')->getAlignment()->setHorizontal(Alignment::HORIZONTAL_RIGHT);\n$spreadsheet->getActiveSheet()->getStyle('E27')->getFont()->setHyperlinkTheme();\n\n// Add a drawing to the worksheet\n$helper->log('Add a drawing to the worksheet');\n$drawing = new Drawing();\n$drawing->setName('Logo');\n$drawing->setDescription('Logo');\n$drawing->setPath(__DIR__ . '/../images/officelogo.jpg');\n$drawing->setHeight(36);\n$drawing->setWorksheet($spreadsheet->getActiveSheet());\n\n// Add a drawing to the worksheet\n$helper->log('Add a drawing to the worksheet');\n$drawing = new Drawing();\n$drawing->setName('Paid');\n$drawing->setDescription('Paid');\n$drawing->setPath(__DIR__ . '/../images/paid.png');\n$drawing->setCoordinates('B15');\n$drawing->setOffsetX(110);\n$drawing->setRotation(25);\n$drawing->getShadow()->setVisible(true);\n$drawing->getShadow()->setDirection(45);\n$drawing->setWorksheet($spreadsheet->getActiveSheet());\n\n// Add a drawing to the worksheet\n$helper->log('Add a drawing to the worksheet');\n$drawing = new Drawing();\n$drawing->setName('PhpSpreadsheet logo');\n$drawing->setDescription('PhpSpreadsheet logo');\n$drawing->setPath(__DIR__ . '/../images/PhpSpreadsheet_logo.png');\n$drawing->setHeight(36);\n$drawing->setCoordinates('D24');\n$drawing->setOffsetX(10);\n$drawing->setWorksheet($spreadsheet->getActiveSheet());\n\n// Play around with inserting and removing rows and columns\n$helper->log('Play around with inserting and removing rows and columns');\n$spreadsheet->getActiveSheet()->insertNewRowBefore(6, 10);\n$spreadsheet->getActiveSheet()->removeRow(6, 10);\n$spreadsheet->getActiveSheet()->insertNewColumnBefore('E', 5);\n$spreadsheet->getActiveSheet()->removeColumn('E', 5);\n\n// Set header and footer. When no different headers for odd/even are used, odd header is assumed.\n$helper->log('Set header/footer');\n$spreadsheet->getActiveSheet()->getHeaderFooter()->setOddHeader('&L&BInvoice&RPrinted on &D');\n$spreadsheet->getActiveSheet()->getHeaderFooter()->setOddFooter('&L&B' . $spreadsheet->getProperties()->getTitle() . '&RPage &P of &N');\n\n// Set page orientation and size\n$helper->log('Set page orientation and size');\n$spreadsheet->getActiveSheet()->getPageSetup()->setOrientation(PageSetup::ORIENTATION_PORTRAIT);\n$spreadsheet->getActiveSheet()->getPageSetup()->setPaperSize(PageSetup::PAPERSIZE_A4);\n\n// Rename first worksheet\n$helper->log('Rename first worksheet');\n$spreadsheet->getActiveSheet()->setTitle('Invoice');\n\n// Create a new worksheet, after the default sheet\n$helper->log('Create a second Worksheet object');\n$spreadsheet->createSheet();\n\n// Llorem ipsum...\n$sLloremIpsum = 'Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Vivamus eget ante. Sed cursus nunc semper tortor. Aliquam luctus purus non elit. Fusce vel elit commodo sapien dignissim dignissim. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Curabitur accumsan magna sed massa. Nullam bibendum quam ac ipsum. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Proin augue. Praesent malesuada justo sed orci. Pellentesque lacus ligula, sodales quis, ultricies a, ultricies vitae, elit. Sed luctus consectetuer dolor. Vivamus vel sem ut nisi sodales accumsan. Nunc et felis. Suspendisse semper viverra odio. Morbi at odio. Integer a orci a purus venenatis molestie. Nam mattis. Praesent rhoncus, nisi vel mattis auctor, neque nisi faucibus sem, non dapibus elit pede ac nisl. Cras turpis.';\n\n// Add some data to the second sheet, resembling some different data types\n$helper->log('Add some data');\n$spreadsheet->setActiveSheetIndex(1);\n$spreadsheet->getActiveSheet()->setCellValue('A1', 'Terms and conditions');\n$spreadsheet->getActiveSheet()->setCellValue('A3', $sLloremIpsum);\n$spreadsheet->getActiveSheet()->setCellValue('A4', $sLloremIpsum);\n$spreadsheet->getActiveSheet()->setCellValue('A5', $sLloremIpsum);\n$spreadsheet->getActiveSheet()->setCellValue('A6', $sLloremIpsum);\n\n// Set the worksheet tab color\n$helper->log('Set the worksheet tab color');\n$spreadsheet->getActiveSheet()->getTabColor()->setARGB('FF0094FF');\n\n// Set alignments\n$helper->log('Set alignments');\n$spreadsheet->getActiveSheet()->getStyle('A3:A6')->getAlignment()->setWrapText(true);\n\n// Set column widths\n$helper->log('Set column widths');\n$spreadsheet->getActiveSheet()->getColumnDimension('A')->setWidth(80);\n\n// Set fonts\n$helper->log('Set fonts');\n$spreadsheet->getActiveSheet()->getStyle('A1')->getFont()->setName('Candara');\n$spreadsheet->getActiveSheet()->getStyle('A1')->getFont()->setSize(20);\n$spreadsheet->getActiveSheet()->getStyle('A1')->getFont()->setBold(true);\n$spreadsheet->getActiveSheet()->getStyle('A1')->getFont()->setUnderline(Font::UNDERLINE_SINGLE);\n\n$spreadsheet->getActiveSheet()->getStyle('A3:A6')->getFont()->setSize(8);\n\n// Add a drawing to the worksheet\n$helper->log('Add a drawing to the worksheet');\n$drawing = new Drawing();\n$drawing->setName('Terms and conditions');\n$drawing->setDescription('Terms and conditions');\n$drawing->setPath(__DIR__ . '/../images/termsconditions.jpg');\n$drawing->setCoordinates('B14');\n$drawing->setWorksheet($spreadsheet->getActiveSheet());\n\n// Set page orientation and size\n$helper->log('Set page orientation and size');\n$spreadsheet->getActiveSheet()->getPageSetup()->setOrientation(PageSetup::ORIENTATION_LANDSCAPE);\n$spreadsheet->getActiveSheet()->getPageSetup()->setPaperSize(PageSetup::PAPERSIZE_A4);\n\n// Rename second worksheet\n$helper->log('Rename second worksheet');\n$spreadsheet->getActiveSheet()->setTitle('Terms and conditions');\n\n// Set active sheet index to the first sheet, so Excel opens this as the first sheet\n$spreadsheet->setActiveSheetIndex(0);\n\nreturn $spreadsheet;\n"
},
{
"path": "samples/templates/sampleSpreadsheet2.php",
"content": "log('Create new Spreadsheet object');\n$spreadsheet = new Spreadsheet();\n\n// Set document properties\n$helper->log('Set document properties');\n$spreadsheet->getProperties()->setCreator('Maarten Balliauw')\n ->setLastModifiedBy('Maarten Balliauw')\n ->setTitle('Office 2007 XLSX Test Document')\n ->setSubject('Office 2007 XLSX Test Document')\n ->setDescription('Test document for Office 2007 XLSX, generated using PHP classes.')\n ->setKeywords('office 2007 openxml php')\n ->setCategory('Test result file');\n\n// Create a first sheet, representing sales data\n$helper->log('Add some data');\n$spreadsheet->setActiveSheetIndex(0);\n$spreadsheet->getActiveSheet()->setCellValue('B1', 'Invoice');\n$date = new DateTime('now');\n$date->setTime(0, 0, 0);\n$spreadsheet->getActiveSheet()->setCellValue('D1', Date::PHPToExcel($date));\n$spreadsheet->getActiveSheet()->getStyle('D1')->getNumberFormat()->setFormatCode(NumberFormat::FORMAT_DATE_XLSX15);\n$spreadsheet->getActiveSheet()->setCellValue('E1', '#12566');\n\n$spreadsheet->getActiveSheet()->setCellValue('A3', 'Product Id');\n$spreadsheet->getActiveSheet()->setCellValue('B3', 'Description');\n$spreadsheet->getActiveSheet()->setCellValue('C3', 'Price');\n$spreadsheet->getActiveSheet()->setCellValue('D3', 'Amount');\n$spreadsheet->getActiveSheet()->setCellValue('E3', 'Total');\n\n$spreadsheet->getActiveSheet()->setCellValue('A4', '1001');\n$spreadsheet->getActiveSheet()->setCellValue('B4', 'PHP for dummies');\n$spreadsheet->getActiveSheet()->setCellValue('C4', '20');\n$spreadsheet->getActiveSheet()->setCellValue('D4', '1');\n$spreadsheet->getActiveSheet()->setCellValue('E4', '=IF(D4<>\"\",C4*D4,\"\")');\n\n$spreadsheet->getActiveSheet()->setCellValue('A5', '1012');\n$spreadsheet->getActiveSheet()->setCellValue('B5', 'OpenXML for dummies');\n$spreadsheet->getActiveSheet()->setCellValue('C5', '22');\n$spreadsheet->getActiveSheet()->setCellValue('D5', '2');\n$spreadsheet->getActiveSheet()->setCellValue('E5', '=IF(D5<>\"\",C5*D5,\"\")');\n\n$spreadsheet->getActiveSheet()->setCellValue('E6', '=IF(D6<>\"\",C6*D6,\"\")');\n$spreadsheet->getActiveSheet()->setCellValue('E7', '=IF(D7<>\"\",C7*D7,\"\")');\n$spreadsheet->getActiveSheet()->setCellValue('E8', '=IF(D8<>\"\",C8*D8,\"\")');\n$spreadsheet->getActiveSheet()->setCellValue('E9', '=IF(D9<>\"\",C9*D9,\"\")');\n\n$spreadsheet->getActiveSheet()->setCellValue('D11', 'Total excl.:');\n$spreadsheet->getActiveSheet()->setCellValue('E11', '=SUM(E4:E9)');\n\n$spreadsheet->getActiveSheet()->setCellValue('D12', 'VAT:');\n$spreadsheet->getActiveSheet()->setCellValue('E12', '=E11*0.21');\n\n$spreadsheet->getActiveSheet()->setCellValue('D13', 'Total incl.:');\n$spreadsheet->getActiveSheet()->setCellValue('E13', '=E11+E12');\n\n// Add comment\n$helper->log('Add comments');\n\n$spreadsheet->getActiveSheet()->getComment('E11')->setAuthor('PhpSpreadsheet');\n$commentRichText = $spreadsheet->getActiveSheet()->getComment('E11')->getText()->createTextRun('PhpSpreadsheet:');\n$commentRichText->getFontOrThrow()->setBold(true);\n$spreadsheet->getActiveSheet()->getComment('E11')->getText()->createTextRun(\"\\r\\n\");\n$spreadsheet->getActiveSheet()->getComment('E11')->getText()->createTextRun('Total amount on the current invoice, excluding VAT.');\n\n$spreadsheet->getActiveSheet()->getComment('E12')->setAuthor('PhpSpreadsheet');\n$commentRichText = $spreadsheet->getActiveSheet()->getComment('E12')->getText()->createTextRun('PhpSpreadsheet:');\n$commentRichText->getFontOrThrow()->setBold(true);\n$spreadsheet->getActiveSheet()->getComment('E12')->getText()->createTextRun(\"\\r\\n\");\n$spreadsheet->getActiveSheet()->getComment('E12')->getText()->createTextRun('Total amount of VAT on the current invoice.');\n\n$spreadsheet->getActiveSheet()->getComment('E13')->setAuthor('PhpSpreadsheet');\n$commentRichText = $spreadsheet->getActiveSheet()->getComment('E13')->getText()->createTextRun('PhpSpreadsheet:');\n$commentRichText->getFontOrThrow()->setBold(true);\n$spreadsheet->getActiveSheet()->getComment('E13')->getText()->createTextRun(\"\\r\\n\");\n$spreadsheet->getActiveSheet()->getComment('E13')->getText()->createTextRun('Total amount on the current invoice, including VAT.');\n$spreadsheet->getActiveSheet()->getComment('E13')->setWidth('100pt');\n$spreadsheet->getActiveSheet()->getComment('E13')->setHeight('100pt');\n$spreadsheet->getActiveSheet()->getComment('E13')->setMarginLeft('150pt');\n$spreadsheet->getActiveSheet()->getComment('E13')->getFillColor()->setRGB('EEEEEE');\n\n// Add rich-text string\n$helper->log('Add rich-text string');\n$richText = new RichText();\n$richText->createText('This invoice is ');\n\n$payable = $richText->createTextRun('payable within thirty days after the end of the month');\n$payable->getFontOrThrow()->setBold(true);\n$payable->getFontOrThrow()->setItalic(true);\n$payable->getFontOrThrow()->setColor(new Color(Color::COLOR_DARKGREEN));\n\n$richText->createText(', unless specified otherwise on the invoice.');\n\n$spreadsheet->getActiveSheet()->getCell('A18')->setValue($richText);\n\n// Merge cells\n$helper->log('Merge cells');\n$spreadsheet->getActiveSheet()->mergeCells('A18:E22');\n$spreadsheet->getActiveSheet()->mergeCells('A28:B28'); // Just to test...\n$spreadsheet->getActiveSheet()->unmergeCells('A28:B28'); // Just to test...\n// Protect cells\n$helper->log('Protect cells');\n$spreadsheet->getActiveSheet()->getProtection()->setSheet(true); // Needs to be set to true in order to enable any worksheet protection!\n$spreadsheet->getActiveSheet()->protectCells('A3:E13', 'PhpSpreadsheet');\n\n// Set cell number formats\n$helper->log('Set cell number formats');\n$spreadsheet->getActiveSheet()->getStyle('E4:E13')->getNumberFormat()->setFormatCode(NumberFormat::FORMAT_CURRENCY_EUR_INTEGER);\n\n// Set column widths\n$helper->log('Set column widths');\n$spreadsheet->getActiveSheet()->getColumnDimension('B')->setAutoSize(true);\n$spreadsheet->getActiveSheet()->getColumnDimension('D')->setWidth(12);\n$spreadsheet->getActiveSheet()->getColumnDimension('E')->setWidth(12);\n\n// Set fonts\n$helper->log('Set fonts');\n$spreadsheet->getActiveSheet()->getStyle('B1')->getFont()->setName('Candara');\n$spreadsheet->getActiveSheet()->getStyle('B1')->getFont()->setSize(20);\n$spreadsheet->getActiveSheet()->getStyle('B1')->getFont()->setBold(true);\n$spreadsheet->getActiveSheet()->getStyle('B1')->getFont()->setUnderline(Font::UNDERLINE_SINGLE);\n$spreadsheet->getActiveSheet()->getStyle('B1')->getFont()->getColor()->setARGB(Color::COLOR_WHITE);\n\n$spreadsheet->getActiveSheet()->getStyle('D1')->getFont()->getColor()->setARGB(Color::COLOR_WHITE);\n$spreadsheet->getActiveSheet()->getStyle('E1')->getFont()->getColor()->setARGB(Color::COLOR_WHITE);\n\n$spreadsheet->getActiveSheet()->getStyle('D13')->getFont()->setBold(true);\n$spreadsheet->getActiveSheet()->getStyle('E13')->getFont()->setBold(true);\n\n// Set alignments\n$helper->log('Set alignments');\n$spreadsheet->getActiveSheet()->getStyle('D11')->getAlignment()->setHorizontal(Alignment::HORIZONTAL_RIGHT);\n$spreadsheet->getActiveSheet()->getStyle('D12')->getAlignment()->setHorizontal(Alignment::HORIZONTAL_RIGHT);\n$spreadsheet->getActiveSheet()->getStyle('D13')->getAlignment()->setHorizontal(Alignment::HORIZONTAL_RIGHT);\n\n$spreadsheet->getActiveSheet()->getStyle('A18')->getAlignment()->setHorizontal(Alignment::HORIZONTAL_JUSTIFY);\n$spreadsheet->getActiveSheet()->getStyle('A18')->getAlignment()->setVertical(Alignment::VERTICAL_CENTER);\n\n$spreadsheet->getActiveSheet()->getStyle('B5')->getAlignment()->setShrinkToFit(true);\n\n// Set thin black border outline around column\n$helper->log('Set thin black border outline around column');\n$styleThinBlackBorderOutline = [\n 'borders' => [\n 'outline' => [\n 'borderStyle' => Border::BORDER_THIN,\n 'color' => ['argb' => 'FF000000'],\n ],\n ],\n];\n$spreadsheet->getActiveSheet()->getStyle('A4:E10')->applyFromArray($styleThinBlackBorderOutline);\n\n// Set thick brown border outline around \"Total\"\n$helper->log('Set thick brown border outline around Total');\n$styleThickBrownBorderOutline = [\n 'borders' => [\n 'outline' => [\n 'borderStyle' => Border::BORDER_THICK,\n 'color' => ['argb' => 'FF993300'],\n ],\n ],\n];\n$spreadsheet->getActiveSheet()->getStyle('D13:E13')->applyFromArray($styleThickBrownBorderOutline);\n\n// Set fills\n$helper->log('Set fills');\n$spreadsheet->getActiveSheet()->getStyle('A1:E1')->getFill()->setFillType(Fill::FILL_SOLID);\n$spreadsheet->getActiveSheet()->getStyle('A1:E1')->getFill()->getStartColor()->setARGB('FF808080');\n\n// Set style for header row using alternative method\n$helper->log('Set style for header row using alternative method');\n$spreadsheet->getActiveSheet()->getStyle('A3:E3')->applyFromArray(\n [\n 'font' => [\n 'bold' => true,\n ],\n 'alignment' => [\n 'horizontal' => Alignment::HORIZONTAL_RIGHT,\n ],\n 'borders' => [\n 'top' => [\n 'borderStyle' => Border::BORDER_THIN,\n ],\n ],\n 'fill' => [\n 'fillType' => Fill::FILL_GRADIENT_LINEAR,\n 'rotation' => 90,\n 'startColor' => [\n 'argb' => 'FFA0A0A0',\n ],\n 'endColor' => [\n 'argb' => 'FFFFFFFF',\n ],\n ],\n ]\n);\n\n$spreadsheet->getActiveSheet()->getStyle('A3')->applyFromArray(\n [\n 'alignment' => [\n 'horizontal' => Alignment::HORIZONTAL_LEFT,\n ],\n 'borders' => [\n 'left' => [\n 'borderStyle' => Border::BORDER_THIN,\n ],\n ],\n ]\n);\n\n$spreadsheet->getActiveSheet()->getStyle('B3')->applyFromArray(\n [\n 'alignment' => [\n 'horizontal' => Alignment::HORIZONTAL_LEFT,\n ],\n ]\n);\n\n$spreadsheet->getActiveSheet()->getStyle('E3')->applyFromArray(\n [\n 'borders' => [\n 'right' => [\n 'borderStyle' => Border::BORDER_THIN,\n ],\n ],\n ]\n);\n\n// Unprotect a cell\n$helper->log('Unprotect a cell');\n$spreadsheet->getActiveSheet()->getStyle('B1')->getProtection()->setLocked(Protection::PROTECTION_UNPROTECTED);\n\n// Add a hyperlink to the sheet\n$helper->log('Add a hyperlink to an external website');\n$spreadsheet->getActiveSheet()->setCellValue('E26', 'www.example.com');\n$spreadsheet->getActiveSheet()->getCell('E26')->getHyperlink()->setUrl('https://www.example.com');\n$spreadsheet->getActiveSheet()->getCell('E26')->getHyperlink()->setTooltip('Navigate to website');\n$spreadsheet->getActiveSheet()->getStyle('E26')->getAlignment()->setHorizontal(Alignment::HORIZONTAL_RIGHT);\n$spreadsheet->getActiveSheet()->getStyle('E26')->getFont()->setHyperlinkTheme();\n\n$helper->log('Add a hyperlink to another cell on a different worksheet within the workbook');\n$spreadsheet->getActiveSheet()->setCellValue('E27', 'Terms and conditions');\n$spreadsheet->getActiveSheet()->getCell('E27')->getHyperlink()->setUrl(\"sheet://'Terms and conditions'!A1\");\n$spreadsheet->getActiveSheet()->getCell('E27')->getHyperlink()->setTooltip('Review terms and conditions');\n$spreadsheet->getActiveSheet()->getStyle('E27')->getAlignment()->setHorizontal(Alignment::HORIZONTAL_RIGHT);\n$spreadsheet->getActiveSheet()->getStyle('E27')->getFont()->setHyperlinkTheme();\n\n// Add a drawing to the worksheet\n$helper->log('Add a drawing to the worksheet');\n$drawing = new Drawing();\n$drawing->setName('Logo');\n$drawing->setDescription('Logo');\n$drawing->setPath(__DIR__ . '/../images/officelogo.jpg');\n$drawing->setHeight(36);\n$drawing->setWorksheet($spreadsheet->getActiveSheet());\n\n// Add a drawing to the worksheet\n$helper->log('Add a drawing to the worksheet');\n$drawing = new Drawing();\n$drawing->setName('Paid');\n$drawing->setDescription('Paid');\n$drawing->setPath(__DIR__ . '/../images/paid.png');\n$drawing->setCoordinates('B15');\n$drawing->setOffsetX(110);\n$drawing->setRotation(25);\n$drawing->getShadow()->setVisible(true);\n$drawing->getShadow()->setDirection(45);\n$drawing->setWorksheet($spreadsheet->getActiveSheet());\n\n// Add a drawing to the worksheet\n$helper->log('Add a drawing with Japanese file name to the worksheet');\n$drawing = new Drawing();\n$drawing->setName('PhpSpreadsheet logo');\n$drawing->setDescription('PhpSpreadsheet logo');\n$drawing->setPath(__DIR__ . '/../images/サンプル.png');\n$drawing->setHeight(36);\n$drawing->setCoordinates('D24');\n$drawing->setOffsetX(10);\n$drawing->setWorksheet($spreadsheet->getActiveSheet());\n\n// Play around with inserting and removing rows and columns\n$helper->log('Play around with inserting and removing rows and columns');\n$spreadsheet->getActiveSheet()->insertNewRowBefore(6, 10);\n$spreadsheet->getActiveSheet()->removeRow(6, 10);\n$spreadsheet->getActiveSheet()->insertNewColumnBefore('E', 5);\n$spreadsheet->getActiveSheet()->removeColumn('E', 5);\n\n// Set header and footer. When no different headers for odd/even are used, odd header is assumed.\n$helper->log('Set header/footer');\n$spreadsheet->getActiveSheet()->getHeaderFooter()->setOddHeader('&L&BInvoice&RPrinted on &D');\n$spreadsheet->getActiveSheet()->getHeaderFooter()->setOddFooter('&L&B' . $spreadsheet->getProperties()->getTitle() . '&RPage &P of &N');\n\n// Set page orientation and size\n$helper->log('Set page orientation and size');\n$spreadsheet->getActiveSheet()->getPageSetup()->setOrientation(PageSetup::ORIENTATION_PORTRAIT);\n$spreadsheet->getActiveSheet()->getPageSetup()->setPaperSize(PageSetup::PAPERSIZE_A4);\n\n// Rename first worksheet\n$helper->log('Rename first worksheet');\n$spreadsheet->getActiveSheet()->setTitle('Invoice');\n\n// Create a new worksheet, after the default sheet\n$helper->log('Create a second Worksheet object');\n$spreadsheet->createSheet();\n\n// Llorem ipsum...\n$sLloremIpsum = 'Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Vivamus eget ante. Sed cursus nunc semper tortor. Aliquam luctus purus non elit. Fusce vel elit commodo sapien dignissim dignissim. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Curabitur accumsan magna sed massa. Nullam bibendum quam ac ipsum. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Proin augue. Praesent malesuada justo sed orci. Pellentesque lacus ligula, sodales quis, ultricies a, ultricies vitae, elit. Sed luctus consectetuer dolor. Vivamus vel sem ut nisi sodales accumsan. Nunc et felis. Suspendisse semper viverra odio. Morbi at odio. Integer a orci a purus venenatis molestie. Nam mattis. Praesent rhoncus, nisi vel mattis auctor, neque nisi faucibus sem, non dapibus elit pede ac nisl. Cras turpis.';\n\n// Add some data to the second sheet, resembling some different data types\n$helper->log('Add some data');\n$spreadsheet->setActiveSheetIndex(1);\n$spreadsheet->getActiveSheet()->setCellValue('A1', 'Terms and conditions');\n$spreadsheet->getActiveSheet()->setCellValue('A3', $sLloremIpsum);\n$spreadsheet->getActiveSheet()->setCellValue('A4', $sLloremIpsum);\n$spreadsheet->getActiveSheet()->setCellValue('A5', $sLloremIpsum);\n$spreadsheet->getActiveSheet()->setCellValue('A6', $sLloremIpsum);\n\n// Set the worksheet tab color\n$helper->log('Set the worksheet tab color');\n$spreadsheet->getActiveSheet()->getTabColor()->setARGB('FF0094FF');\n\n// Set alignments\n$helper->log('Set alignments');\n$spreadsheet->getActiveSheet()->getStyle('A3:A6')->getAlignment()->setWrapText(true);\n\n// Set column widths\n$helper->log('Set column widths');\n$spreadsheet->getActiveSheet()->getColumnDimension('A')->setWidth(80);\n\n// Set fonts\n$helper->log('Set fonts');\n$spreadsheet->getActiveSheet()->getStyle('A1')->getFont()->setName('Candara');\n$spreadsheet->getActiveSheet()->getStyle('A1')->getFont()->setSize(20);\n$spreadsheet->getActiveSheet()->getStyle('A1')->getFont()->setBold(true);\n$spreadsheet->getActiveSheet()->getStyle('A1')->getFont()->setUnderline(Font::UNDERLINE_SINGLE);\n\n$spreadsheet->getActiveSheet()->getStyle('A3:A6')->getFont()->setSize(8);\n\n// Add a drawing to the worksheet\n$helper->log('Add a drawing with space and # in filename to the worksheet');\n$drawing = new Drawing();\n$drawing->setName('Terms and conditions');\n$drawing->setDescription('Terms and conditions');\n$drawing->setPath(__DIR__ . '/../images/terms con#ditions.jpg');\n$drawing->setCoordinates('B14');\n$drawing->setWorksheet($spreadsheet->getActiveSheet());\n\n// Repeat drawing to the worksheet\n$helper->log('Repeat drawing from other worksheet on this one');\n$drawing = new Drawing();\n$drawing->setName('PhpSpreadsheet logo');\n$drawing->setDescription('PhpSpreadsheet logo');\n$drawing->setPath(__DIR__ . '/../images/サンプル.png');\n$drawing->setHeight(36);\n$drawing->setCoordinates('B18');\n$drawing->setOffsetX(10);\n$drawing->setWorksheet($spreadsheet->getActiveSheet());\n\n// Set page orientation and size\n$helper->log('Set page orientation and size');\n$spreadsheet->getActiveSheet()->getPageSetup()->setOrientation(PageSetup::ORIENTATION_LANDSCAPE);\n$spreadsheet->getActiveSheet()->getPageSetup()->setPaperSize(PageSetup::PAPERSIZE_A4);\n\n// Rename second worksheet\n$helper->log('Rename second worksheet');\n$spreadsheet->getActiveSheet()->setTitle('Terms and conditions');\n\n// Set active sheet index to the first sheet, so Excel opens this as the first sheet\n$spreadsheet->setActiveSheetIndex(0);\n\nreturn $spreadsheet;\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/ArrayEnabled.php",
"content": "initialise($arguments);\n }\n\n /**\n * Handles array argument processing when the function accepts a single argument that can be an array argument.\n * Example use for:\n * DAYOFMONTH() or FACT().\n *\n * @param mixed[] $values\n *\n * @return mixed[]\n */\n protected static function evaluateSingleArgumentArray(callable $method, array $values): array\n {\n $result = [];\n foreach ($values as $value) {\n $result[] = $method($value);\n }\n\n return $result;\n }\n\n /**\n * Handles array argument processing when the function accepts multiple arguments,\n * and any of them can be an array argument.\n * Example use for:\n * ROUND() or DATE().\n *\n * @return mixed[]\n */\n protected static function evaluateArrayArguments(callable $method, mixed ...$arguments): array\n {\n self::initialiseHelper($arguments);\n $arguments = self::$arrayArgumentHelper->arguments();\n\n return ArrayArgumentProcessor::processArguments(self::$arrayArgumentHelper, $method, ...$arguments);\n }\n\n /**\n * Handles array argument processing when the function accepts multiple arguments,\n * but only the first few (up to limit) can be an array arguments.\n * Example use for:\n * NETWORKDAYS() or CONCATENATE(), where the last argument is a matrix (or a series of values) that need\n * to be treated as a such rather than as an array arguments.\n *\n * @return mixed[]\n */\n protected static function evaluateArrayArgumentsSubset(callable $method, int $limit, mixed ...$arguments): array\n {\n self::initialiseHelper(array_slice($arguments, 0, $limit));\n $trailingArguments = array_slice($arguments, $limit);\n $arguments = self::$arrayArgumentHelper->arguments();\n $arguments = array_merge($arguments, $trailingArguments);\n\n return ArrayArgumentProcessor::processArguments(self::$arrayArgumentHelper, $method, ...$arguments);\n }\n\n private static function testFalse(mixed $value): bool\n {\n return $value === false;\n }\n\n /**\n * Handles array argument processing when the function accepts multiple arguments,\n * but only the last few (from start) can be an array arguments.\n * Example use for:\n * Z.TEST() or INDEX(), where the first argument 1 is a matrix that needs to be treated as a dataset\n * rather than as an array argument.\n *\n * @return mixed[]\n */\n protected static function evaluateArrayArgumentsSubsetFrom(callable $method, int $start, mixed ...$arguments): array\n {\n $arrayArgumentsSubset = array_combine(\n range($start, count($arguments) - $start),\n array_slice($arguments, $start)\n );\n if (self::testFalse($arrayArgumentsSubset)) {\n return ['#VALUE!'];\n }\n\n self::initialiseHelper($arrayArgumentsSubset);\n $leadingArguments = array_slice($arguments, 0, $start);\n $arguments = self::$arrayArgumentHelper->arguments();\n $arguments = array_merge($leadingArguments, $arguments);\n\n return ArrayArgumentProcessor::processArguments(self::$arrayArgumentHelper, $method, ...$arguments);\n }\n\n /**\n * Handles array argument processing when the function accepts multiple arguments,\n * and any of them can be an array argument except for the one specified by ignore.\n * Example use for:\n * HLOOKUP() and VLOOKUP(), where argument 1 is a matrix that needs to be treated as a database\n * rather than as an array argument.\n *\n * @return mixed[]\n */\n protected static function evaluateArrayArgumentsIgnore(callable $method, int $ignore, mixed ...$arguments): array\n {\n $leadingArguments = array_slice($arguments, 0, $ignore);\n $ignoreArgument = array_slice($arguments, $ignore, 1);\n $trailingArguments = array_slice($arguments, $ignore + 1);\n\n self::initialiseHelper(array_merge($leadingArguments, [[null]], $trailingArguments));\n $arguments = self::$arrayArgumentHelper->arguments();\n\n array_splice($arguments, $ignore, 1, $ignoreArgument);\n\n return ArrayArgumentProcessor::processArguments(self::$arrayArgumentHelper, $method, ...$arguments);\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/BinaryComparison.php",
"content": " '' && $operand1[0] == Calculation::FORMULA_STRING_QUOTE) {\n $operand1 = Calculation::unwrapResult($operand1);\n }\n if (ErrorValue::isError($operand1, true)) {\n /** @var string $operand1 */\n return $operand1;\n }\n if (is_string($operand2) && $operand2 > '' && $operand2[0] == Calculation::FORMULA_STRING_QUOTE) {\n $operand2 = Calculation::unwrapResult($operand2);\n }\n if (ErrorValue::isError($operand2, true)) {\n /** @var string $operand2 */\n return $operand2;\n }\n\n // Use case-insensitive comparison if not OpenOffice mode\n if (Functions::getCompatibilityMode() != Functions::COMPATIBILITY_OPENOFFICE) {\n if (is_string($operand1)) {\n $operand1 = StringHelper::strToUpper($operand1);\n }\n if (is_string($operand2)) {\n $operand2 = StringHelper::strToUpper($operand2);\n }\n }\n\n $useLowercaseFirstComparison = is_string($operand1)\n && is_string($operand2)\n && Functions::getCompatibilityMode() === Functions::COMPATIBILITY_OPENOFFICE;\n\n return self::evaluateComparison($operand1, $operand2, $operator, $useLowercaseFirstComparison);\n }\n\n private static function evaluateComparison(mixed $operand1, mixed $operand2, string $operator, bool $useLowercaseFirstComparison): bool\n {\n return match ($operator) {\n '=' => self::equal($operand1, $operand2),\n '>' => self::greaterThan($operand1, $operand2, $useLowercaseFirstComparison),\n '<' => self::lessThan($operand1, $operand2, $useLowercaseFirstComparison),\n '>=' => self::greaterThanOrEqual($operand1, $operand2, $useLowercaseFirstComparison),\n '<=' => self::lessThanOrEqual($operand1, $operand2, $useLowercaseFirstComparison),\n '<>' => self::notEqual($operand1, $operand2),\n default => throw new Exception('Unsupported binary comparison operator'),\n };\n }\n\n private static function equal(mixed $operand1, mixed $operand2): bool\n {\n if (is_numeric($operand1) && is_numeric($operand2)) {\n $result = (abs($operand1 - $operand2) < self::DELTA);\n } elseif (($operand1 === null && is_numeric($operand2)) || ($operand2 === null && is_numeric($operand1))) {\n $result = $operand1 == $operand2;\n } else {\n $result = self::strcmpAllowNull($operand1, $operand2) == 0;\n }\n\n return $result;\n }\n\n private static function greaterThanOrEqual(mixed $operand1, mixed $operand2, bool $useLowercaseFirstComparison): bool\n {\n if (is_numeric($operand1) && is_numeric($operand2)) {\n $result = ((abs($operand1 - $operand2) < self::DELTA) || ($operand1 > $operand2));\n } elseif (($operand1 === null && is_numeric($operand2)) || ($operand2 === null && is_numeric($operand1))) {\n $result = $operand1 >= $operand2;\n } elseif ($useLowercaseFirstComparison) {\n $result = self::strcmpLowercaseFirst($operand1, $operand2) >= 0;\n } else {\n $result = self::strcmpAllowNull($operand1, $operand2) >= 0;\n }\n\n return $result;\n }\n\n private static function lessThanOrEqual(mixed $operand1, mixed $operand2, bool $useLowercaseFirstComparison): bool\n {\n if (is_numeric($operand1) && is_numeric($operand2)) {\n $result = ((abs($operand1 - $operand2) < self::DELTA) || ($operand1 < $operand2));\n } elseif (($operand1 === null && is_numeric($operand2)) || ($operand2 === null && is_numeric($operand1))) {\n $result = $operand1 <= $operand2;\n } elseif ($useLowercaseFirstComparison) {\n $result = self::strcmpLowercaseFirst($operand1, $operand2) <= 0;\n } else {\n $result = self::strcmpAllowNull($operand1, $operand2) <= 0;\n }\n\n return $result;\n }\n\n private static function greaterThan(mixed $operand1, mixed $operand2, bool $useLowercaseFirstComparison): bool\n {\n return self::lessThanOrEqual($operand1, $operand2, $useLowercaseFirstComparison) !== true;\n }\n\n private static function lessThan(mixed $operand1, mixed $operand2, bool $useLowercaseFirstComparison): bool\n {\n return self::greaterThanOrEqual($operand1, $operand2, $useLowercaseFirstComparison) !== true;\n }\n\n private static function notEqual(mixed $operand1, mixed $operand2): bool\n {\n return self::equal($operand1, $operand2) !== true;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Calculation.php",
"content": "=:`-]*)|(\\'(?:[^\\']|\\'[^!])+?\\')|(\\\"(?:[^\\\"]|\\\"[^!])+?\\\"))!)?\\$?\\b([a-z]{1,3})\\$?(\\d{1,7})(?![\\w.])';\n // Used only to detect spill operator #\n const CALCULATION_REGEXP_CELLREF_SPILL = '/' . self::CALCULATION_REGEXP_CELLREF . '#/i';\n // Cell reference (with or without a sheet reference) ensuring absolute/relative\n const CALCULATION_REGEXP_CELLREF_RELATIVE = '((([^\\s\\(,!&%^\\/\\*\\+<>=:`-]*)|(\\'(?:[^\\']|\\'[^!])+?\\')|(\\\"(?:[^\\\"]|\\\"[^!])+?\\\"))!)?(\\$?\\b[a-z]{1,3})(\\$?\\d{1,7})(?![\\w.])';\n const CALCULATION_REGEXP_COLUMN_RANGE = '(((([^\\s\\(,!&%^\\/\\*\\+<>=:`-]*)|(\\'(?:[^\\']|\\'[^!])+?\\')|(\\\".(?:[^\\\"]|\\\"[^!])?\\\"))!)?(\\$?[a-z]{1,3})):(?![.*])';\n const CALCULATION_REGEXP_ROW_RANGE = '(((([^\\s\\(,!&%^\\/\\*\\+<>=:`-]*)|(\\'(?:[^\\']|\\'[^!])+?\\')|(\\\"(?:[^\\\"]|\\\"[^!])+?\\\"))!)?(\\$?[1-9][0-9]{0,6})):(?![.*])';\n // Cell reference (with or without a sheet reference) ensuring absolute/relative\n // Cell ranges ensuring absolute/relative\n const CALCULATION_REGEXP_COLUMNRANGE_RELATIVE = '(\\$?[a-z]{1,3}):(\\$?[a-z]{1,3})';\n const CALCULATION_REGEXP_ROWRANGE_RELATIVE = '(\\$?\\d{1,7}):(\\$?\\d{1,7})';\n // Defined Names: Named Range of cells, or Named Formulae\n const CALCULATION_REGEXP_DEFINEDNAME = '((([^\\s,!&%^\\/\\*\\+<>=-]*)|(\\'(?:[^\\']|\\'[^!])+?\\')|(\\\"(?:[^\\\"]|\\\"[^!])+?\\\"))!)?([_\\p{L}][_\\p{L}\\p{N}\\.]*)';\n // Structured Reference (Fully Qualified and Unqualified)\n const CALCULATION_REGEXP_STRUCTURED_REFERENCE = '([\\p{L}_\\\\\\][\\p{L}\\p{N}\\._]+)?(\\[(?:[^\\d\\]+-])?)';\n // Error\n const CALCULATION_REGEXP_ERROR = '\\#[A-Z][A-Z0_\\/]*[!\\?]?';\n\n /** constants */\n const RETURN_ARRAY_AS_ERROR = 'error';\n const RETURN_ARRAY_AS_VALUE = 'value';\n const RETURN_ARRAY_AS_ARRAY = 'array';\n\n /** Preferable to use instance variable instanceArrayReturnType rather than this static property. */\n private static string $returnArrayAsType = self::RETURN_ARRAY_AS_VALUE;\n\n /** Preferable to use this instance variable rather than static returnArrayAsType */\n private ?string $instanceArrayReturnType = null;\n\n /**\n * Instance of this class.\n */\n private static ?Calculation $instance = null;\n\n /**\n * Instance of the spreadsheet this Calculation Engine is using.\n */\n private ?Spreadsheet $spreadsheet;\n\n /**\n * Calculation cache.\n *\n * @var mixed[]\n */\n private array $calculationCache = [];\n\n /**\n * Calculation cache enabled.\n */\n private bool $calculationCacheEnabled = true;\n\n private BranchPruner $branchPruner;\n\n protected bool $branchPruningEnabled = true;\n\n /**\n * List of operators that can be used within formulae\n * The true/false value indicates whether it is a binary operator or a unary operator.\n */\n private const CALCULATION_OPERATORS = [\n '+' => true, '-' => true, '*' => true, '/' => true,\n '^' => true, '&' => true, '%' => false, '~' => false,\n '>' => true, '<' => true, '=' => true, '>=' => true,\n '<=' => true, '<>' => true, '∩' => true, '∪' => true,\n ':' => true,\n ];\n\n /**\n * List of binary operators (those that expect two operands).\n */\n private const BINARY_OPERATORS = [\n '+' => true, '-' => true, '*' => true, '/' => true,\n '^' => true, '&' => true, '>' => true, '<' => true,\n '=' => true, '>=' => true, '<=' => true, '<>' => true,\n '∩' => true, '∪' => true, ':' => true,\n ];\n\n /**\n * The debug log generated by the calculation engine.\n */\n private Logger $debugLog;\n\n private bool $suppressFormulaErrors = false;\n\n private bool $processingAnchorArray = false;\n\n /**\n * Error message for any error that was raised/thrown by the calculation engine.\n */\n public ?string $formulaError = null;\n\n /**\n * An array of the nested cell references accessed by the calculation engine, used for the debug log.\n */\n private CyclicReferenceStack $cyclicReferenceStack;\n\n /** @var mixed[] */\n private array $cellStack = [];\n\n /**\n * Current iteration counter for cyclic formulae\n * If the value is 0 (or less) then cyclic formulae will throw an exception,\n * otherwise they will iterate to the limit defined here before returning a result.\n */\n private int $cyclicFormulaCounter = 1;\n\n private string $cyclicFormulaCell = '';\n\n /**\n * Number of iterations for cyclic formulae.\n */\n public int $cyclicFormulaCount = 1;\n\n /**\n * Excel constant string translations to their PHP equivalents\n * Constant conversion from text name/value to actual (datatyped) value.\n */\n private const EXCEL_CONSTANTS = [\n 'TRUE' => true,\n 'FALSE' => false,\n 'NULL' => null,\n ];\n\n public static function keyInExcelConstants(string $key): bool\n {\n return array_key_exists($key, self::EXCEL_CONSTANTS);\n }\n\n public static function getExcelConstants(string $key): bool|null\n {\n return self::EXCEL_CONSTANTS[$key];\n }\n\n /**\n * Internal functions used for special control purposes.\n *\n * @var array|string>>\n */\n private static array $controlFunctions = [\n 'MKMATRIX' => [\n 'argumentCount' => '*',\n 'functionCall' => [Internal\\MakeMatrix::class, 'make'],\n ],\n 'NAME.ERROR' => [\n 'argumentCount' => '*',\n 'functionCall' => [ExcelError::class, 'NAME'],\n ],\n 'WILDCARDMATCH' => [\n 'argumentCount' => '2',\n 'functionCall' => [Internal\\WildcardMatch::class, 'compare'],\n ],\n ];\n\n public function __construct(?Spreadsheet $spreadsheet = null)\n {\n $this->spreadsheet = $spreadsheet;\n $this->cyclicReferenceStack = new CyclicReferenceStack();\n $this->debugLog = new Logger($this->cyclicReferenceStack);\n $this->branchPruner = new BranchPruner($this->branchPruningEnabled);\n }\n\n /**\n * Get an instance of this class.\n *\n * @param ?Spreadsheet $spreadsheet Injected spreadsheet for working with a PhpSpreadsheet Spreadsheet object,\n * or NULL to create a standalone calculation engine\n */\n public static function getInstance(?Spreadsheet $spreadsheet = null): self\n {\n if ($spreadsheet !== null) {\n return $spreadsheet->getCalculationEngine();\n }\n\n if (!self::$instance) {\n self::$instance = new self();\n }\n\n return self::$instance;\n }\n\n /**\n * Intended for use only via a destructor.\n *\n * @internal\n */\n public static function getInstanceOrNull(?Spreadsheet $spreadsheet = null): ?self\n {\n if ($spreadsheet !== null) {\n return $spreadsheet->getCalculationEngineOrNull();\n }\n\n return null;\n }\n\n /**\n * Flush the calculation cache for any existing instance of this class\n * but only if a Calculation instance exists.\n */\n public function flushInstance(): void\n {\n $this->clearCalculationCache();\n $this->branchPruner->clearBranchStore();\n }\n\n /**\n * Get the Logger for this calculation engine instance.\n */\n public function getDebugLog(): Logger\n {\n return $this->debugLog;\n }\n\n /**\n * __clone implementation. Cloning should not be allowed in a Singleton!\n */\n final public function __clone()\n {\n throw new Exception('Cloning the calculation engine is not allowed!');\n }\n\n /**\n * Set the Array Return Type (Array or Value of first element in the array).\n *\n * @param string $returnType Array return type\n *\n * @return bool Success or failure\n */\n public static function setArrayReturnType(string $returnType): bool\n {\n if (\n ($returnType == self::RETURN_ARRAY_AS_VALUE)\n || ($returnType == self::RETURN_ARRAY_AS_ERROR)\n || ($returnType == self::RETURN_ARRAY_AS_ARRAY)\n ) {\n self::$returnArrayAsType = $returnType;\n\n return true;\n }\n\n return false;\n }\n\n /**\n * Return the Array Return Type (Array or Value of first element in the array).\n *\n * @return string $returnType Array return type\n */\n public static function getArrayReturnType(): string\n {\n return self::$returnArrayAsType;\n }\n\n /**\n * Set the Instance Array Return Type (Array or Value of first element in the array).\n *\n * @param string $returnType Array return type\n *\n * @return bool Success or failure\n */\n public function setInstanceArrayReturnType(string $returnType): bool\n {\n if (\n ($returnType == self::RETURN_ARRAY_AS_VALUE)\n || ($returnType == self::RETURN_ARRAY_AS_ERROR)\n || ($returnType == self::RETURN_ARRAY_AS_ARRAY)\n ) {\n $this->instanceArrayReturnType = $returnType;\n\n return true;\n }\n\n return false;\n }\n\n /**\n * Return the Array Return Type (Array or Value of first element in the array).\n *\n * @return string $returnType Array return type for instance if non-null, otherwise static property\n */\n public function getInstanceArrayReturnType(): string\n {\n return $this->instanceArrayReturnType ?? self::$returnArrayAsType;\n }\n\n /**\n * Is calculation caching enabled?\n */\n public function getCalculationCacheEnabled(): bool\n {\n return $this->calculationCacheEnabled;\n }\n\n /**\n * Enable/disable calculation cache.\n */\n public function setCalculationCacheEnabled(bool $calculationCacheEnabled): self\n {\n $this->calculationCacheEnabled = $calculationCacheEnabled;\n $this->clearCalculationCache();\n\n return $this;\n }\n\n /**\n * Enable calculation cache.\n */\n public function enableCalculationCache(): void\n {\n $this->setCalculationCacheEnabled(true);\n }\n\n /**\n * Disable calculation cache.\n */\n public function disableCalculationCache(): void\n {\n $this->setCalculationCacheEnabled(false);\n }\n\n /**\n * Clear calculation cache.\n */\n public function clearCalculationCache(): void\n {\n $this->calculationCache = [];\n }\n\n /**\n * Clear calculation cache for a specified worksheet.\n */\n public function clearCalculationCacheForWorksheet(string $worksheetName): void\n {\n if (isset($this->calculationCache[$worksheetName])) {\n unset($this->calculationCache[$worksheetName]);\n }\n }\n\n /**\n * Rename calculation cache for a specified worksheet.\n */\n public function renameCalculationCacheForWorksheet(string $fromWorksheetName, string $toWorksheetName): void\n {\n if (isset($this->calculationCache[$fromWorksheetName])) {\n $this->calculationCache[$toWorksheetName] = &$this->calculationCache[$fromWorksheetName];\n unset($this->calculationCache[$fromWorksheetName]);\n }\n }\n\n public function getBranchPruningEnabled(): bool\n {\n return $this->branchPruningEnabled;\n }\n\n public function setBranchPruningEnabled(mixed $enabled): self\n {\n $this->branchPruningEnabled = (bool) $enabled;\n $this->branchPruner = new BranchPruner($this->branchPruningEnabled);\n\n return $this;\n }\n\n public function enableBranchPruning(): void\n {\n $this->setBranchPruningEnabled(true);\n }\n\n public function disableBranchPruning(): void\n {\n $this->setBranchPruningEnabled(false);\n }\n\n /**\n * Wrap string values in quotes.\n */\n public static function wrapResult(mixed $value): mixed\n {\n if (is_string($value)) {\n // Error values cannot be \"wrapped\"\n if (Preg::isMatch('/^' . self::CALCULATION_REGEXP_ERROR . '$/i', $value, $match)) {\n // Return Excel errors \"as is\"\n return $value;\n }\n\n // Return strings wrapped in quotes\n return self::FORMULA_STRING_QUOTE . $value . self::FORMULA_STRING_QUOTE;\n } elseif ((is_float($value)) && ((is_nan($value)) || (is_infinite($value)))) {\n // Convert numeric errors to NaN error\n return ExcelError::NAN();\n }\n\n return $value;\n }\n\n /**\n * Remove quotes used as a wrapper to identify string values.\n */\n public static function unwrapResult(mixed $value): mixed\n {\n if (is_string($value)) {\n if ((isset($value[0])) && ($value[0] == self::FORMULA_STRING_QUOTE) && (substr($value, -1) == self::FORMULA_STRING_QUOTE)) {\n return substr($value, 1, -1);\n }\n // Convert numeric errors to NAN error\n } elseif ((is_float($value)) && ((is_nan($value)) || (is_infinite($value)))) {\n return ExcelError::NAN();\n }\n\n return $value;\n }\n\n /**\n * Calculate cell value (using formula from a cell ID)\n * Retained for backward compatibility.\n *\n * @param ?Cell $cell Cell to calculate\n */\n public function calculate(?Cell $cell = null): mixed\n {\n try {\n return $this->calculateCellValue($cell);\n } catch (\\Exception $e) {\n throw new Exception($e->getMessage());\n }\n }\n\n /**\n * Calculate the value of a cell formula.\n *\n * @param ?Cell $cell Cell to calculate\n * @param bool $resetLog Flag indicating whether the debug log should be reset or not\n */\n public function calculateCellValue(?Cell $cell = null, bool $resetLog = true): mixed\n {\n if ($cell === null) {\n return null;\n }\n\n if ($resetLog) {\n // Initialise the logging settings if requested\n $this->formulaError = null;\n $this->debugLog->clearLog();\n $this->cyclicReferenceStack->clear();\n $this->cyclicFormulaCounter = 1;\n }\n\n // Execute the calculation for the cell formula\n $this->cellStack[] = [\n 'sheet' => $cell->getWorksheet()->getTitle(),\n 'cell' => $cell->getCoordinate(),\n ];\n\n $cellAddressAttempted = false;\n $cellAddress = null;\n\n try {\n $value = $cell->getValue();\n if (is_string($value) && $cell->getDataType() === DataType::TYPE_FORMULA) {\n $value = Preg::replaceCallback(\n self::CALCULATION_REGEXP_CELLREF_SPILL,\n fn (array $matches) => 'ANCHORARRAY(' . substr($matches[0], 0, -1) . ')',\n $value\n );\n }\n $result = self::unwrapResult($this->_calculateFormulaValue($value, $cell->getCoordinate(), $cell)); //* @phpstan-ignore-line\n if ($this->spreadsheet === null) {\n throw new Exception('null spreadsheet in calculateCellValue');\n }\n $cellAddressAttempted = true;\n $cellAddress = array_pop($this->cellStack);\n if ($cellAddress === null) {\n throw new Exception('null cellAddress in calculateCellValue');\n }\n /** @var array{sheet: string, cell: string} $cellAddress */\n $testSheet = $this->spreadsheet->getSheetByName($cellAddress['sheet']);\n if ($testSheet === null) {\n throw new Exception('worksheet not found in calculateCellValue');\n }\n $testSheet->getCell($cellAddress['cell']);\n } catch (\\Exception $e) {\n if (!$cellAddressAttempted) {\n $cellAddress = array_pop($this->cellStack);\n }\n if ($this->spreadsheet !== null && is_array($cellAddress) && array_key_exists('sheet', $cellAddress)) {\n $sheetName = $cellAddress['sheet'] ?? null;\n $testSheet = is_string($sheetName) ? $this->spreadsheet->getSheetByName($sheetName) : null;\n if ($testSheet !== null && array_key_exists('cell', $cellAddress)) {\n /** @var array{cell: string} $cellAddress */\n $testSheet->getCell($cellAddress['cell']);\n }\n }\n\n throw new Exception($e->getMessage(), $e->getCode(), $e);\n }\n\n if (is_array($result) && $this->getInstanceArrayReturnType() !== self::RETURN_ARRAY_AS_ARRAY) {\n $testResult = Functions::flattenArray($result);\n if ($this->getInstanceArrayReturnType() == self::RETURN_ARRAY_AS_ERROR) {\n return ExcelError::VALUE();\n }\n $result = array_shift($testResult);\n }\n\n if ($result === null && $cell->getWorksheet()->getSheetView()->getShowZeros()) {\n return 0;\n } elseif ((is_float($result)) && ((is_nan($result)) || (is_infinite($result)))) {\n return ExcelError::NAN();\n }\n\n return $result;\n }\n\n /**\n * Validate and parse a formula string.\n *\n * @param string $formula Formula to parse\n *\n * @return array|bool\n */\n public function parseFormula(string $formula): array|bool\n {\n $formula = Preg::replaceCallback(\n self::CALCULATION_REGEXP_CELLREF_SPILL,\n fn (array $matches) => 'ANCHORARRAY(' . substr($matches[0], 0, -1) . ')',\n $formula\n );\n // Basic validation that this is indeed a formula\n // We return an empty array if not\n $formula = trim($formula);\n if ((!isset($formula[0])) || ($formula[0] != '=')) {\n return [];\n }\n $formula = ltrim(substr($formula, 1));\n if (!isset($formula[0])) {\n return [];\n }\n\n // Parse the formula and return the token stack\n return $this->internalParseFormula($formula);\n }\n\n /**\n * Calculate the value of a formula.\n *\n * @param string $formula Formula to parse\n * @param ?string $cellID Address of the cell to calculate\n * @param ?Cell $cell Cell to calculate\n */\n public function calculateFormula(string $formula, ?string $cellID = null, ?Cell $cell = null): mixed\n {\n // Initialise the logging settings\n $this->formulaError = null;\n $this->debugLog->clearLog();\n $this->cyclicReferenceStack->clear();\n\n $resetCache = $this->getCalculationCacheEnabled();\n if ($this->spreadsheet !== null && $cellID === null && $cell === null) {\n $cellID = 'A1';\n $cell = $this->spreadsheet->getActiveSheet()->getCell($cellID);\n } else {\n // Disable calculation cacheing because it only applies to cell calculations, not straight formulae\n // But don't actually flush any cache\n $this->calculationCacheEnabled = false;\n }\n\n // Execute the calculation\n try {\n $result = self::unwrapResult($this->_calculateFormulaValue($formula, $cellID, $cell));\n } catch (\\Exception $e) {\n throw new Exception($e->getMessage());\n }\n\n if ($this->spreadsheet === null) {\n // Reset calculation cacheing to its previous state\n $this->calculationCacheEnabled = $resetCache;\n }\n\n return $result;\n }\n\n public function getValueFromCache(string $cellReference, mixed &$cellValue): bool\n {\n $this->debugLog->writeDebugLog('Testing cache value for cell %s', $cellReference);\n // Is calculation cacheing enabled?\n // If so, is the required value present in calculation cache?\n if (($this->calculationCacheEnabled) && (isset($this->calculationCache[$cellReference]))) {\n $this->debugLog->writeDebugLog('Retrieving value for cell %s from cache', $cellReference);\n // Return the cached result\n\n $cellValue = $this->calculationCache[$cellReference];\n\n return true;\n }\n\n return false;\n }\n\n public function saveValueToCache(string $cellReference, mixed $cellValue): void\n {\n if ($this->calculationCacheEnabled) {\n $this->calculationCache[$cellReference] = $cellValue;\n }\n }\n\n /**\n * Parse a cell formula and calculate its value.\n *\n * @param string $formula The formula to parse and calculate\n * @param ?string $cellID The ID (e.g. A3) of the cell that we are calculating\n * @param ?Cell $cell Cell to calculate\n * @param bool $ignoreQuotePrefix If set to true, evaluate the formyla even if the referenced cell is quote prefixed\n */\n public function _calculateFormulaValue(string $formula, ?string $cellID = null, ?Cell $cell = null, bool $ignoreQuotePrefix = false): mixed\n {\n $cellValue = null;\n\n // Quote-Prefixed cell values cannot be formulae, but are treated as strings\n if ($cell !== null && $ignoreQuotePrefix === false && $cell->getStyle()->getQuotePrefix() === true) {\n return self::wrapResult((string) $formula);\n }\n\n // https://www.reddit.com/r/excel/comments/chr41y/cmd_formula_stopped_working_since_last_update/\n if (preg_match('/^=\\s*cmd\\s*\\|/miu', $formula) !== 0) {\n return ExcelError::REF(); // returns #BLOCKED in newer versions\n }\n\n // Basic validation that this is indeed a formula\n // We simply return the cell value if not\n $formula = trim($formula);\n if ($formula === '' || $formula[0] !== '=') {\n return self::wrapResult($formula);\n }\n $formula = ltrim(substr($formula, 1));\n if (!isset($formula[0])) {\n return self::wrapResult($formula);\n }\n\n $pCellParent = ($cell !== null) ? $cell->getWorksheet() : null;\n $wsTitle = ($pCellParent !== null) ? $pCellParent->getTitle() : \"\\x00Wrk\";\n $wsCellReference = $wsTitle . '!' . $cellID;\n\n if (($cellID !== null) && ($this->getValueFromCache($wsCellReference, $cellValue))) {\n return $cellValue;\n }\n $this->debugLog->writeDebugLog('Evaluating formula for cell %s', $wsCellReference);\n\n if (($wsTitle[0] !== \"\\x00\") && ($this->cyclicReferenceStack->onStack($wsCellReference))) {\n if ($this->cyclicFormulaCount <= 0) {\n $this->cyclicFormulaCell = '';\n\n return $this->raiseFormulaError('Cyclic Reference in Formula');\n } elseif ($this->cyclicFormulaCell === $wsCellReference) {\n ++$this->cyclicFormulaCounter;\n if ($this->cyclicFormulaCounter >= $this->cyclicFormulaCount) {\n $this->cyclicFormulaCell = '';\n\n return $cellValue;\n }\n } elseif ($this->cyclicFormulaCell == '') {\n if ($this->cyclicFormulaCounter >= $this->cyclicFormulaCount) {\n return $cellValue;\n }\n $this->cyclicFormulaCell = $wsCellReference;\n }\n }\n\n $this->debugLog->writeDebugLog('Formula for cell %s is %s', $wsCellReference, $formula);\n // Parse the formula onto the token stack and calculate the value\n $this->cyclicReferenceStack->push($wsCellReference);\n\n $cellValue = $this->processTokenStack($this->internalParseFormula($formula, $cell), $cellID, $cell);\n $this->cyclicReferenceStack->pop();\n\n // Save to calculation cache\n if ($cellID !== null) {\n $this->saveValueToCache($wsCellReference, $cellValue);\n }\n\n // Return the calculated value\n return $cellValue;\n }\n\n /**\n * Ensure that paired matrix operands are both matrices and of the same size.\n *\n * @param mixed $operand1 First matrix operand\n *\n * @param-out mixed[] $operand1\n *\n * @param mixed $operand2 Second matrix operand\n *\n * @param-out mixed[] $operand2\n *\n * @param int $resize Flag indicating whether the matrices should be resized to match\n * and (if so), whether the smaller dimension should grow or the\n * larger should shrink.\n * 0 = no resize\n * 1 = shrink to fit\n * 2 = extend to fit\n *\n * @return mixed[]\n */\n public static function checkMatrixOperands(mixed &$operand1, mixed &$operand2, int $resize = 1): array\n {\n // Examine each of the two operands, and turn them into an array if they aren't one already\n // Note that this function should only be called if one or both of the operand is already an array\n if (!is_array($operand1)) {\n if (is_array($operand2)) {\n [$matrixRows, $matrixColumns] = self::getMatrixDimensions($operand2);\n $operand1 = array_fill(0, $matrixRows, array_fill(0, $matrixColumns, $operand1));\n $resize = 0;\n } else {\n $operand1 = [$operand1];\n $operand2 = [$operand2];\n }\n } elseif (!is_array($operand2)) {\n [$matrixRows, $matrixColumns] = self::getMatrixDimensions($operand1);\n $operand2 = array_fill(0, $matrixRows, array_fill(0, $matrixColumns, $operand2));\n $resize = 0;\n }\n\n [$matrix1Rows, $matrix1Columns] = self::getMatrixDimensions($operand1);\n [$matrix2Rows, $matrix2Columns] = self::getMatrixDimensions($operand2);\n if ($resize === 3) {\n $resize = 2;\n } elseif (($matrix1Rows == $matrix2Columns) && ($matrix2Rows == $matrix1Columns)) {\n $resize = 1;\n }\n\n if ($resize == 2) {\n // Given two matrices of (potentially) unequal size, convert the smaller in each dimension to match the larger\n self::resizeMatricesExtend($operand1, $operand2, $matrix1Rows, $matrix1Columns, $matrix2Rows, $matrix2Columns);\n } elseif ($resize == 1) {\n // Given two matrices of (potentially) unequal size, convert the larger in each dimension to match the smaller\n /** @var mixed[][] $operand1 */\n /** @var mixed[][] $operand2 */\n self::resizeMatricesShrink($operand1, $operand2, $matrix1Rows, $matrix1Columns, $matrix2Rows, $matrix2Columns);\n }\n [$matrix1Rows, $matrix1Columns] = self::getMatrixDimensions($operand1);\n [$matrix2Rows, $matrix2Columns] = self::getMatrixDimensions($operand2);\n\n return [$matrix1Rows, $matrix1Columns, $matrix2Rows, $matrix2Columns];\n }\n\n /**\n * Read the dimensions of a matrix, and re-index it with straight numeric keys starting from row 0, column 0.\n *\n * @param mixed[] $matrix matrix operand\n *\n * @return int[] An array comprising the number of rows, and number of columns\n */\n public static function getMatrixDimensions(array &$matrix): array\n {\n $matrixRows = count($matrix);\n $matrixColumns = 0;\n foreach ($matrix as $rowKey => $rowValue) {\n if (!is_array($rowValue)) {\n $matrix[$rowKey] = [$rowValue];\n $matrixColumns = max(1, $matrixColumns);\n } else {\n $matrix[$rowKey] = array_values($rowValue);\n $matrixColumns = max(count($rowValue), $matrixColumns);\n }\n }\n $matrix = array_values($matrix);\n\n return [$matrixRows, $matrixColumns];\n }\n\n /**\n * Ensure that paired matrix operands are both matrices of the same size.\n *\n * @param mixed[][] $matrix1 First matrix operand\n * @param mixed[][] $matrix2 Second matrix operand\n * @param int $matrix1Rows Row size of first matrix operand\n * @param int $matrix1Columns Column size of first matrix operand\n * @param int $matrix2Rows Row size of second matrix operand\n * @param int $matrix2Columns Column size of second matrix operand\n */\n private static function resizeMatricesShrink(array &$matrix1, array &$matrix2, int $matrix1Rows, int $matrix1Columns, int $matrix2Rows, int $matrix2Columns): void\n {\n if (($matrix2Columns < $matrix1Columns) || ($matrix2Rows < $matrix1Rows)) {\n if ($matrix2Rows < $matrix1Rows) {\n for ($i = $matrix2Rows; $i < $matrix1Rows; ++$i) {\n unset($matrix1[$i]);\n }\n }\n if ($matrix2Columns < $matrix1Columns) {\n for ($i = 0; $i < $matrix1Rows; ++$i) {\n for ($j = $matrix2Columns; $j < $matrix1Columns; ++$j) {\n unset($matrix1[$i][$j]);\n }\n }\n }\n }\n\n if (($matrix1Columns < $matrix2Columns) || ($matrix1Rows < $matrix2Rows)) {\n if ($matrix1Rows < $matrix2Rows) {\n for ($i = $matrix1Rows; $i < $matrix2Rows; ++$i) {\n unset($matrix2[$i]);\n }\n }\n if ($matrix1Columns < $matrix2Columns) {\n for ($i = 0; $i < $matrix2Rows; ++$i) {\n for ($j = $matrix1Columns; $j < $matrix2Columns; ++$j) {\n unset($matrix2[$i][$j]);\n }\n }\n }\n }\n }\n\n /**\n * Ensure that paired matrix operands are both matrices of the same size.\n *\n * @param mixed[] $matrix1 First matrix operand\n * @param mixed[] $matrix2 Second matrix operand\n * @param int $matrix1Rows Row size of first matrix operand\n * @param int $matrix1Columns Column size of first matrix operand\n * @param int $matrix2Rows Row size of second matrix operand\n * @param int $matrix2Columns Column size of second matrix operand\n */\n private static function resizeMatricesExtend(array &$matrix1, array &$matrix2, int $matrix1Rows, int $matrix1Columns, int $matrix2Rows, int $matrix2Columns): void\n {\n if (($matrix2Columns < $matrix1Columns) || ($matrix2Rows < $matrix1Rows)) {\n if ($matrix2Columns < $matrix1Columns) {\n for ($i = 0; $i < $matrix2Rows; ++$i) {\n /** @var mixed[][] $matrix2 */\n $x = ($matrix2Columns === 1) ? $matrix2[$i][0] : null;\n for ($j = $matrix2Columns; $j < $matrix1Columns; ++$j) {\n $matrix2[$i][$j] = $x;\n }\n }\n }\n if ($matrix2Rows < $matrix1Rows) {\n $x = ($matrix2Rows === 1) ? $matrix2[0] : array_fill(0, $matrix2Columns, null);\n for ($i = $matrix2Rows; $i < $matrix1Rows; ++$i) {\n $matrix2[$i] = $x;\n }\n }\n }\n\n if (($matrix1Columns < $matrix2Columns) || ($matrix1Rows < $matrix2Rows)) {\n if ($matrix1Columns < $matrix2Columns) {\n for ($i = 0; $i < $matrix1Rows; ++$i) {\n /** @var mixed[][] $matrix1 */\n $x = ($matrix1Columns === 1) ? $matrix1[$i][0] : null;\n for ($j = $matrix1Columns; $j < $matrix2Columns; ++$j) {\n $matrix1[$i][$j] = $x;\n }\n }\n }\n if ($matrix1Rows < $matrix2Rows) {\n $x = ($matrix1Rows === 1) ? $matrix1[0] : array_fill(0, $matrix2Columns, null);\n for ($i = $matrix1Rows; $i < $matrix2Rows; ++$i) {\n $matrix1[$i] = $x;\n }\n }\n }\n }\n\n /**\n * Format details of an operand for display in the log (based on operand type).\n *\n * @param mixed $value First matrix operand\n */\n private function showValue(mixed $value): mixed\n {\n if ($this->debugLog->getWriteDebugLog()) {\n $testArray = Functions::flattenArray($value);\n if (count($testArray) == 1) {\n $value = array_pop($testArray);\n }\n\n if (is_array($value)) {\n $returnMatrix = [];\n $pad = $rpad = ', ';\n foreach ($value as $row) {\n if (is_array($row)) {\n $returnMatrix[] = implode($pad, array_map([$this, 'showValue'], $row));\n $rpad = '; ';\n } else {\n $returnMatrix[] = $this->showValue($row);\n }\n }\n\n return '{ ' . implode($rpad, $returnMatrix) . ' }';\n } elseif (is_string($value) && (trim($value, self::FORMULA_STRING_QUOTE) == $value)) {\n return self::FORMULA_STRING_QUOTE . $value . self::FORMULA_STRING_QUOTE;\n } elseif (is_bool($value)) {\n return ($value) ? self::$localeBoolean['TRUE'] : self::$localeBoolean['FALSE'];\n } elseif ($value === null) {\n return self::$localeBoolean['NULL'];\n }\n }\n\n return Functions::flattenSingleValue($value);\n }\n\n /**\n * Format type and details of an operand for display in the log (based on operand type).\n *\n * @param mixed $value First matrix operand\n */\n private function showTypeDetails(mixed $value): ?string\n {\n if ($this->debugLog->getWriteDebugLog()) {\n $testArray = Functions::flattenArray($value);\n if (count($testArray) == 1) {\n $value = array_pop($testArray);\n }\n\n if ($value === null) {\n return 'a NULL value';\n } elseif (is_float($value)) {\n $typeString = 'a floating point number';\n } elseif (is_int($value)) {\n $typeString = 'an integer number';\n } elseif (is_bool($value)) {\n $typeString = 'a boolean';\n } elseif (is_array($value)) {\n $typeString = 'a matrix';\n } else {\n /** @var string $value */\n if ($value == '') {\n return 'an empty string';\n } elseif ($value[0] == '#') {\n return 'a ' . $value . ' error';\n }\n $typeString = 'a string';\n }\n\n return $typeString . ' with a value of ' . StringHelper::convertToString($this->showValue($value));\n }\n\n return null;\n }\n\n private const MATRIX_REPLACE_FROM = [self::FORMULA_OPEN_MATRIX_BRACE, ';', self::FORMULA_CLOSE_MATRIX_BRACE];\n private const MATRIX_REPLACE_TO = ['MKMATRIX(MKMATRIX(', '),MKMATRIX(', '))'];\n\n /**\n * @return false|string False indicates an error\n */\n private function convertMatrixReferences(string $formula): false|string\n {\n // Convert any Excel matrix references to the MKMATRIX() function\n if (str_contains($formula, self::FORMULA_OPEN_MATRIX_BRACE)) {\n // If there is the possibility of braces within a quoted string, then we don't treat those as matrix indicators\n if (str_contains($formula, self::FORMULA_STRING_QUOTE)) {\n // So instead we skip replacing in any quoted strings by only replacing in every other array element after we've exploded\n // the formula\n $temp = explode(self::FORMULA_STRING_QUOTE, $formula);\n // Open and Closed counts used for trapping mismatched braces in the formula\n $openCount = $closeCount = 0;\n $notWithinQuotes = false;\n foreach ($temp as &$value) {\n // Only count/replace in alternating array entries\n $notWithinQuotes = $notWithinQuotes === false;\n if ($notWithinQuotes === true) {\n $openCount += substr_count($value, self::FORMULA_OPEN_MATRIX_BRACE);\n $closeCount += substr_count($value, self::FORMULA_CLOSE_MATRIX_BRACE);\n $value = str_replace(self::MATRIX_REPLACE_FROM, self::MATRIX_REPLACE_TO, $value);\n }\n }\n unset($value);\n // Then rebuild the formula string\n $formula = implode(self::FORMULA_STRING_QUOTE, $temp);\n } else {\n // If there's no quoted strings, then we do a simple count/replace\n $openCount = substr_count($formula, self::FORMULA_OPEN_MATRIX_BRACE);\n $closeCount = substr_count($formula, self::FORMULA_CLOSE_MATRIX_BRACE);\n $formula = str_replace(self::MATRIX_REPLACE_FROM, self::MATRIX_REPLACE_TO, $formula);\n }\n // Trap for mismatched braces and trigger an appropriate error\n if ($openCount < $closeCount) {\n if ($openCount > 0) {\n return $this->raiseFormulaError(\"Formula Error: Mismatched matrix braces '}'\");\n }\n\n return $this->raiseFormulaError(\"Formula Error: Unexpected '}' encountered\");\n } elseif ($openCount > $closeCount) {\n if ($closeCount > 0) {\n return $this->raiseFormulaError(\"Formula Error: Mismatched matrix braces '{'\");\n }\n\n return $this->raiseFormulaError(\"Formula Error: Unexpected '{' encountered\");\n }\n }\n\n return $formula;\n }\n\n /**\n * Comparison (Boolean) Operators.\n * These operators work on two values, but always return a boolean result.\n */\n private const COMPARISON_OPERATORS = ['>' => true, '<' => true, '=' => true, '>=' => true, '<=' => true, '<>' => true];\n\n /**\n * Operator Precedence.\n * This list includes all valid operators, whether binary (including boolean) or unary (such as %).\n * Array key is the operator, the value is its precedence.\n */\n private const OPERATOR_PRECEDENCE = [\n ':' => 9, // Range\n '∩' => 8, // Intersect\n '∪' => 7, // Union\n '~' => 6, // Negation\n '%' => 5, // Percentage\n '^' => 4, // Exponentiation\n '*' => 3, '/' => 3, // Multiplication and Division\n '+' => 2, '-' => 2, // Addition and Subtraction\n '&' => 1, // Concatenation\n '>' => 0, '<' => 0, '=' => 0, '>=' => 0, '<=' => 0, '<>' => 0, // Comparison\n ];\n\n /** @param string[] $matches */\n private static function unionForComma(array $matches): string\n {\n return $matches[1] . str_replace(',', '∪', $matches[2]);\n }\n\n private const CELL_OR_CELLRANGE_OR_DEFINED_NAME\n = '(?:'\n . self::CALCULATION_REGEXP_CELLREF // cell address\n . '(?::' . self::CALCULATION_REGEXP_CELLREF . ')?' // optional range address, non-capturing\n . '|' . self::CALCULATION_REGEXP_DEFINEDNAME\n . ')'\n ;\n\n public const UNIONABLE_COMMAS = '/((?:[,(]|^)\\s*)' // comma or open paren or start of string, followed by optional whitespace\n . '([(]' // open paren\n . self::CELL_OR_CELLRANGE_OR_DEFINED_NAME // cell address\n . '(?:\\s*,\\s*' // optioonal whitespace, comma, optional whitespace, non-capturing\n . self::CELL_OR_CELLRANGE_OR_DEFINED_NAME // cell address\n . ')+' // one or more occurrences\n . '\\s*[)])/i'; // optional whitespace, end paren\n\n /**\n * @return array|false\n */\n private function internalParseFormula(string $formula, ?Cell $cell = null): bool|array\n {\n if (($formula = $this->convertMatrixReferences(trim($formula))) === false) {\n return false;\n }\n\n $oldFormula = $formula;\n $formula = Preg::replaceCallback(self::UNIONABLE_COMMAS, self::unionForComma(...), $formula); // @phpstan-ignore-line\n if ($oldFormula !== $formula) {\n $this->debugLog->writeDebugLog('Reformulated as %s', $formula);\n }\n $phpSpreadsheetFunctions = &self::getFunctionsAddress();\n\n // If we're using cell caching, then $pCell may well be flushed back to the cache (which detaches the parent worksheet),\n // so we store the parent worksheet so that we can re-attach it when necessary\n $pCellParent = ($cell !== null) ? $cell->getWorksheet() : null;\n\n $regexpMatchString = '/^((?' . self::CALCULATION_REGEXP_STRING\n . ')|(?' . self::CALCULATION_REGEXP_FUNCTION\n . ')|(?' . self::CALCULATION_REGEXP_CELLREF\n . ')|(?' . self::CALCULATION_REGEXP_COLUMN_RANGE\n . ')|(?' . self::CALCULATION_REGEXP_ROW_RANGE\n . ')|(?' . self::CALCULATION_REGEXP_NUMBER\n . ')|(?' . self::CALCULATION_REGEXP_OPENBRACE\n . ')|(?' . self::CALCULATION_REGEXP_STRUCTURED_REFERENCE\n . ')|(?' . self::CALCULATION_REGEXP_DEFINEDNAME\n . ')|(?' . self::CALCULATION_REGEXP_ERROR\n . '))/sui';\n\n // Start with initialisation\n $index = 0;\n $stack = new Stack($this->branchPruner);\n $output = [];\n $expectingOperator = false; // We use this test in syntax-checking the expression to determine when a\n // - is a negation or + is a positive operator rather than an operation\n $expectingOperand = false; // We use this test in syntax-checking the expression to determine whether an operand\n // should be null in a function call\n\n // The guts of the lexical parser\n // Loop through the formula extracting each operator and operand in turn\n while (true) {\n // Branch pruning: we adapt the output item to the context (it will\n // be used to limit its computation)\n $this->branchPruner->initialiseForLoop();\n\n $opCharacter = $formula[$index]; // Get the first character of the value at the current index position\n if ($opCharacter === \"\\xe2\") { // intersection or union\n $opCharacter .= $formula[++$index];\n $opCharacter .= $formula[++$index];\n }\n\n // Check for two-character operators (e.g. >=, <=, <>)\n if ((isset(self::COMPARISON_OPERATORS[$opCharacter])) && (strlen($formula) > $index) && isset($formula[$index + 1], self::COMPARISON_OPERATORS[$formula[$index + 1]])) {\n $opCharacter .= $formula[++$index];\n }\n // Find out if we're currently at the beginning of a number, variable, cell/row/column reference,\n // function, defined name, structured reference, parenthesis, error or operand\n $isOperandOrFunction = (bool) preg_match($regexpMatchString, substr($formula, $index), $match);\n\n $expectingOperatorCopy = $expectingOperator;\n if ($opCharacter === '-' && !$expectingOperator) { // Is it a negation instead of a minus?\n // Put a negation on the stack\n $stack->push('Unary Operator', '~');\n ++$index; // and drop the negation symbol\n } elseif ($opCharacter === '%' && $expectingOperator) {\n // Put a percentage on the stack\n $stack->push('Unary Operator', '%');\n ++$index;\n } elseif ($opCharacter === '+' && !$expectingOperator) { // Positive (unary plus rather than binary operator plus) can be discarded?\n ++$index; // Drop the redundant plus symbol\n } elseif ((($opCharacter === '~') /*|| ($opCharacter === '∩') || ($opCharacter === '∪')*/) && (!$isOperandOrFunction)) {\n // We have to explicitly deny a tilde, union or intersect because they are legal\n return $this->raiseFormulaError(\"Formula Error: Illegal character '~'\"); // on the stack but not in the input expression\n } elseif ((isset(self::CALCULATION_OPERATORS[$opCharacter]) || $isOperandOrFunction) && $expectingOperator) { // Are we putting an operator on the stack?\n while (self::swapOperands($stack, $opCharacter)) {\n $output[] = $stack->pop(); // Swap operands and higher precedence operators from the stack to the output\n }\n\n // Finally put our current operator onto the stack\n $stack->push('Binary Operator', $opCharacter);\n\n ++$index;\n $expectingOperator = false;\n } elseif ($opCharacter === ')' && $expectingOperator) { // Are we expecting to close a parenthesis?\n $expectingOperand = false;\n while (($o2 = $stack->pop()) && $o2['value'] !== '(') { // Pop off the stack back to the last (\n $output[] = $o2;\n }\n $d = $stack->last(2);\n\n // Branch pruning we decrease the depth whether is it a function\n // call or a parenthesis\n $this->branchPruner->decrementDepth();\n\n if (is_array($d) && preg_match('/^' . self::CALCULATION_REGEXP_FUNCTION . '$/miu', StringHelper::convertToString($d['value']), $matches)) {\n // Did this parenthesis just close a function?\n try {\n $this->branchPruner->closingBrace($d['value']);\n } catch (Exception $e) {\n return $this->raiseFormulaError($e->getMessage(), $e->getCode(), $e);\n }\n\n $functionName = $matches[1]; // Get the function name\n $d = $stack->pop();\n $argumentCount = $d['value'] ?? 0; // See how many arguments there were (argument count is the next value stored on the stack)\n $output[] = $d; // Dump the argument count on the output\n $output[] = $stack->pop(); // Pop the function and push onto the output\n if (isset(self::$controlFunctions[$functionName])) {\n $expectedArgumentCount = self::$controlFunctions[$functionName]['argumentCount'];\n } elseif (isset($phpSpreadsheetFunctions[$functionName])) {\n $expectedArgumentCount = $phpSpreadsheetFunctions[$functionName]['argumentCount'];\n } else { // did we somehow push a non-function on the stack? this should never happen\n return $this->raiseFormulaError('Formula Error: Internal error, non-function on stack');\n }\n // Check the argument count\n $argumentCountError = false;\n $expectedArgumentCountString = null;\n if (is_numeric($expectedArgumentCount)) {\n if ($expectedArgumentCount < 0) {\n if ($argumentCount > abs($expectedArgumentCount + 0)) {\n $argumentCountError = true;\n $expectedArgumentCountString = 'no more than ' . abs($expectedArgumentCount + 0);\n }\n } else {\n if ($argumentCount != $expectedArgumentCount) {\n $argumentCountError = true;\n $expectedArgumentCountString = $expectedArgumentCount;\n }\n }\n } elseif (is_string($expectedArgumentCount) && $expectedArgumentCount !== '*') {\n if (!Preg::isMatch('/(\\d*)([-+,])(\\d*)/', $expectedArgumentCount, $argMatch)) {\n $argMatch = ['', '', '', ''];\n }\n switch ($argMatch[2]) {\n case '+':\n if ($argumentCount < $argMatch[1]) {\n $argumentCountError = true;\n $expectedArgumentCountString = $argMatch[1] . ' or more ';\n }\n\n break;\n case '-':\n if (($argumentCount < $argMatch[1]) || ($argumentCount > $argMatch[3])) {\n $argumentCountError = true;\n $expectedArgumentCountString = 'between ' . $argMatch[1] . ' and ' . $argMatch[3];\n }\n\n break;\n case ',':\n if (($argumentCount != $argMatch[1]) && ($argumentCount != $argMatch[3])) {\n $argumentCountError = true;\n $expectedArgumentCountString = 'either ' . $argMatch[1] . ' or ' . $argMatch[3];\n }\n\n break;\n }\n }\n if ($argumentCountError) {\n /** @var int $argumentCount */\n return $this->raiseFormulaError(\"Formula Error: Wrong number of arguments for $functionName() function: $argumentCount given, \" . $expectedArgumentCountString . ' expected');\n }\n }\n ++$index;\n } elseif ($opCharacter === ',') { // Is this the separator for function arguments?\n try {\n $this->branchPruner->argumentSeparator();\n } catch (Exception $e) {\n return $this->raiseFormulaError($e->getMessage(), $e->getCode(), $e);\n }\n\n while (($o2 = $stack->pop()) && $o2['value'] !== '(') { // Pop off the stack back to the last (\n $output[] = $o2; // pop the argument expression stuff and push onto the output\n }\n // If we've a comma when we're expecting an operand, then what we actually have is a null operand;\n // so push a null onto the stack\n if (($expectingOperand) || (!$expectingOperator)) {\n $output[] = $stack->getStackItem('Empty Argument', null, 'NULL');\n }\n // make sure there was a function\n $d = $stack->last(2);\n /** @var string */\n $temp = $d['value'] ?? '';\n if (!preg_match('/^' . self::CALCULATION_REGEXP_FUNCTION . '$/miu', $temp, $matches)) {\n // Can we inject a dummy function at this point so that the braces at least have some context\n // because at least the braces are paired up (at this stage in the formula)\n // MS Excel allows this if the content is cell references; but doesn't allow actual values,\n // but at this point, we can't differentiate (so allow both)\n //return $this->raiseFormulaError('Formula Error: Unexpected ,');\n\n $stack->push('Binary Operator', '∪');\n\n ++$index;\n $expectingOperator = false;\n\n continue;\n }\n\n /** @var array $d */\n $d = $stack->pop();\n ++$d['value']; // increment the argument count\n\n $stack->pushStackItem($d);\n $stack->push('Brace', '('); // put the ( back on, we'll need to pop back to it again\n\n $expectingOperator = false;\n $expectingOperand = true;\n ++$index;\n } elseif ($opCharacter === '(' && !$expectingOperator) {\n // Branch pruning: we go deeper\n $this->branchPruner->incrementDepth();\n $stack->push('Brace', '(', null);\n ++$index;\n } elseif ($isOperandOrFunction && !$expectingOperatorCopy) {\n // do we now have a function/variable/number?\n $expectingOperator = true;\n $expectingOperand = false;\n $val = $match[1] ?? ''; //* @phpstan-ignore-line\n $length = strlen($val);\n\n if (preg_match('/^' . self::CALCULATION_REGEXP_FUNCTION . '$/miu', $val, $matches)) {\n // $val is known to be valid unicode from statement above, so Preg::replace is okay even with u modifier\n $val = Preg::replace('/\\s/u', '', $val);\n if (isset($phpSpreadsheetFunctions[strtoupper($matches[1])]) || isset(self::$controlFunctions[strtoupper($matches[1])])) { // it's a function\n $valToUpper = strtoupper($val);\n } else {\n $valToUpper = 'NAME.ERROR(';\n }\n // here $matches[1] will contain values like \"IF\"\n // and $val \"IF(\"\n\n $this->branchPruner->functionCall($valToUpper);\n\n $stack->push('Function', $valToUpper);\n // tests if the function is closed right after opening\n $ax = preg_match('/^\\s*\\)/u', substr($formula, $index + $length));\n if ($ax) {\n $stack->push('Operand Count for Function ' . $valToUpper . ')', 0);\n $expectingOperator = true;\n } else {\n $stack->push('Operand Count for Function ' . $valToUpper . ')', 1);\n $expectingOperator = false;\n }\n $stack->push('Brace', '(');\n } elseif (preg_match('/^' . self::CALCULATION_REGEXP_CELLREF . '$/miu', $val, $matches)) {\n // Watch for this case-change when modifying to allow cell references in different worksheets...\n // Should only be applied to the actual cell column, not the worksheet name\n // If the last entry on the stack was a : operator, then we have a cell range reference\n $testPrevOp = $stack->last(1);\n if ($testPrevOp !== null && $testPrevOp['value'] === ':') {\n // If we have a worksheet reference, then we're playing with a 3D reference\n if ($matches[2] === '') {\n // Otherwise, we 'inherit' the worksheet reference from the start cell reference\n // The start of the cell range reference should be the last entry in $output\n $rangeStartCellRef = $output[count($output) - 1]['value'] ?? '';\n if ($rangeStartCellRef === ':') {\n // Do we have chained range operators?\n $rangeStartCellRef = $output[count($output) - 2]['value'] ?? '';\n }\n /** @var string $rangeStartCellRef */\n preg_match('/^' . self::CALCULATION_REGEXP_CELLREF . '$/miu', $rangeStartCellRef, $rangeStartMatches);\n if (array_key_exists(2, $rangeStartMatches)) {\n if ($rangeStartMatches[2] > '') {\n $val = $rangeStartMatches[2] . '!' . $val;\n }\n } else {\n $val = ExcelError::REF();\n }\n } else {\n $rangeStartCellRef = $output[count($output) - 1]['value'] ?? '';\n if ($rangeStartCellRef === ':') {\n // Do we have chained range operators?\n $rangeStartCellRef = $output[count($output) - 2]['value'] ?? '';\n }\n /** @var string $rangeStartCellRef */\n preg_match('/^' . self::CALCULATION_REGEXP_CELLREF . '$/miu', $rangeStartCellRef, $rangeStartMatches);\n if (isset($rangeStartMatches[2]) && $rangeStartMatches[2] !== $matches[2]) {\n return $this->raiseFormulaError('3D Range references are not yet supported');\n }\n }\n } elseif (!str_contains($val, '!') && $pCellParent !== null) {\n $worksheet = $pCellParent->getTitle();\n $val = \"'{$worksheet}'!{$val}\";\n }\n // unescape any apostrophes or double quotes in worksheet name\n $val = str_replace([\"''\", '\"\"'], [\"'\", '\"'], $val);\n $outputItem = $stack->getStackItem('Cell Reference', $val, $val);\n\n $output[] = $outputItem;\n } elseif (preg_match('/^' . self::CALCULATION_REGEXP_STRUCTURED_REFERENCE . '$/miu', $val, $matches)) {\n try {\n $structuredReference = Operands\\StructuredReference::fromParser($formula, $index, $matches);\n } catch (Exception $e) {\n return $this->raiseFormulaError($e->getMessage(), $e->getCode(), $e);\n }\n\n $val = $structuredReference->value();\n $length = strlen($val);\n $outputItem = $stack->getStackItem(Operands\\StructuredReference::NAME, $structuredReference, null);\n\n $output[] = $outputItem;\n $expectingOperator = true;\n } else {\n // it's a variable, constant, string, number or boolean\n $localeConstant = false;\n $stackItemType = 'Value';\n $stackItemReference = null;\n\n // If the last entry on the stack was a : operator, then we may have a row or column range reference\n $testPrevOp = $stack->last(1);\n if ($testPrevOp !== null && $testPrevOp['value'] === ':') {\n $stackItemType = 'Cell Reference';\n\n if (\n !is_numeric($val)\n && ((ctype_alpha($val) === false || strlen($val) > 3))\n && (preg_match('/^' . self::CALCULATION_REGEXP_DEFINEDNAME . '$/mui', $val) !== false)\n && ($this->spreadsheet === null || $this->spreadsheet->getNamedRange($val) !== null)\n ) {\n $namedRange = ($this->spreadsheet === null) ? null : $this->spreadsheet->getNamedRange($val);\n if ($namedRange !== null) {\n $stackItemType = 'Defined Name';\n $address = str_replace('$', '', $namedRange->getValue());\n $stackItemReference = $val;\n if (str_contains($address, ':')) {\n // We'll need to manipulate the stack for an actual named range rather than a named cell\n $fromTo = explode(':', $address);\n $to = array_pop($fromTo);\n foreach ($fromTo as $from) {\n $output[] = $stack->getStackItem($stackItemType, $from, $stackItemReference);\n $output[] = $stack->getStackItem('Binary Operator', ':');\n }\n $address = $to;\n }\n $val = $address;\n }\n } elseif ($val === ExcelError::REF()) {\n $stackItemReference = $val;\n } else {\n /** @var non-empty-string $startRowColRef */\n $startRowColRef = $output[count($output) - 1]['value'] ?? '';\n [$rangeWS1, $startRowColRef] = Worksheet::extractSheetTitle($startRowColRef, true);\n $rangeSheetRef = $rangeWS1;\n if ($rangeWS1 !== '') {\n $rangeWS1 .= '!';\n }\n if (str_starts_with($rangeSheetRef, \"'\")) {\n $rangeSheetRef = Worksheet::unApostrophizeTitle($rangeSheetRef);\n }\n [$rangeWS2, $val] = Worksheet::extractSheetTitle($val, true);\n if ($rangeWS2 !== '') {\n $rangeWS2 .= '!';\n } else {\n $rangeWS2 = $rangeWS1;\n }\n\n $refSheet = $pCellParent;\n if ($pCellParent !== null && $rangeSheetRef !== '' && $rangeSheetRef !== $pCellParent->getTitle()) {\n $refSheet = $pCellParent->getParentOrThrow()->getSheetByName($rangeSheetRef);\n }\n\n if (ctype_digit($val) && $val <= AddressRange::MAX_ROW) {\n // Row range\n $stackItemType = 'Row Reference';\n $valx = $val;\n $endRowColRef = ($refSheet !== null) ? $refSheet->getHighestDataColumn($valx) : AddressRange::MAX_COLUMN; // Max 16,384 columns for Excel2007\n $val = \"{$rangeWS2}{$endRowColRef}{$val}\";\n } elseif (ctype_alpha($val) && strlen($val) <= 3) {\n // Column range\n $stackItemType = 'Column Reference';\n $endRowColRef = ($refSheet !== null) ? $refSheet->getHighestDataRow($val) : AddressRange::MAX_ROW; // Max 1,048,576 rows for Excel2007\n $val = \"{$rangeWS2}{$val}{$endRowColRef}\";\n }\n $stackItemReference = $val;\n }\n } elseif ($opCharacter === self::FORMULA_STRING_QUOTE) {\n // UnEscape any quotes within the string\n $val = self::wrapResult(str_replace('\"\"', self::FORMULA_STRING_QUOTE, StringHelper::convertToString(self::unwrapResult($val))));\n } elseif (isset(self::EXCEL_CONSTANTS[trim(strtoupper($val))])) {\n $stackItemType = 'Constant';\n $excelConstant = trim(strtoupper($val));\n $val = self::EXCEL_CONSTANTS[$excelConstant];\n $stackItemReference = $excelConstant;\n } elseif (($localeConstant = array_search(trim(strtoupper($val)), self::$localeBoolean)) !== false) {\n $stackItemType = 'Constant';\n $val = self::EXCEL_CONSTANTS[$localeConstant];\n $stackItemReference = $localeConstant;\n } elseif (\n preg_match('/^' . self::CALCULATION_REGEXP_ROW_RANGE . '/miu', substr($formula, $index), $rowRangeReference)\n ) {\n $val = $rowRangeReference[1];\n $length = strlen($rowRangeReference[1]);\n $stackItemType = 'Row Reference';\n // unescape any apostrophes or double quotes in worksheet name\n $val = str_replace([\"''\", '\"\"'], [\"'\", '\"'], $val);\n $column = 'A';\n if (($testPrevOp !== null && $testPrevOp['value'] === ':') && $pCellParent !== null) {\n $column = $pCellParent->getHighestDataColumn($val);\n }\n $val = \"{$rowRangeReference[2]}{$column}{$rowRangeReference[7]}\";\n $stackItemReference = $val;\n } elseif (\n preg_match('/^' . self::CALCULATION_REGEXP_COLUMN_RANGE . '/miu', substr($formula, $index), $columnRangeReference)\n ) {\n $val = $columnRangeReference[1];\n $length = strlen($val);\n $stackItemType = 'Column Reference';\n // unescape any apostrophes or double quotes in worksheet name\n $val = str_replace([\"''\", '\"\"'], [\"'\", '\"'], $val);\n $row = '1';\n if (($testPrevOp !== null && $testPrevOp['value'] === ':') && $pCellParent !== null) {\n $row = $pCellParent->getHighestDataRow($val);\n }\n $val = \"{$val}{$row}\";\n $stackItemReference = $val;\n } elseif (preg_match('/^' . self::CALCULATION_REGEXP_DEFINEDNAME . '.*/miu', $val, $match)) {\n $stackItemType = 'Defined Name';\n $stackItemReference = $val;\n } elseif (is_numeric($val)) {\n if ((str_contains((string) $val, '.')) || (stripos((string) $val, 'e') !== false) || ($val > PHP_INT_MAX) || ($val < -PHP_INT_MAX)) {\n $val = (float) $val;\n } else {\n $val = (int) $val;\n }\n }\n\n $details = $stack->getStackItem($stackItemType, $val, $stackItemReference);\n if ($localeConstant) {\n $details['localeValue'] = $localeConstant;\n }\n $output[] = $details;\n }\n $index += $length;\n } elseif ($opCharacter === '$') { // absolute row or column range\n ++$index;\n } elseif ($opCharacter === ')') { // miscellaneous error checking\n if ($expectingOperand) {\n $output[] = $stack->getStackItem('Empty Argument', null, 'NULL');\n $expectingOperand = false;\n $expectingOperator = true;\n } else {\n return $this->raiseFormulaError(\"Formula Error: Unexpected ')'\");\n }\n } elseif (isset(self::CALCULATION_OPERATORS[$opCharacter]) && !$expectingOperator) {\n return $this->raiseFormulaError(\"Formula Error: Unexpected operator '$opCharacter'\");\n } else { // I don't even want to know what you did to get here\n return $this->raiseFormulaError('Formula Error: An unexpected error occurred');\n }\n // Test for end of formula string\n if ($index == strlen($formula)) {\n // Did we end with an operator?.\n // Only valid for the % unary operator\n if ((isset(self::CALCULATION_OPERATORS[$opCharacter])) && ($opCharacter != '%')) {\n return $this->raiseFormulaError(\"Formula Error: Operator '$opCharacter' has no operands\");\n }\n\n break;\n }\n // Ignore white space\n while (($formula[$index] === \"\\n\") || ($formula[$index] === \"\\r\")) {\n ++$index;\n }\n\n if ($formula[$index] === ' ') {\n while ($formula[$index] === ' ') {\n ++$index;\n }\n\n // If we're expecting an operator, but only have a space between the previous and next operands (and both are\n // Cell References, Defined Names or Structured References) then we have an INTERSECTION operator\n $countOutputMinus1 = count($output) - 1;\n if (\n ($expectingOperator)\n && array_key_exists($countOutputMinus1, $output)\n && is_array($output[$countOutputMinus1])\n && array_key_exists('type', $output[$countOutputMinus1])\n && (\n (preg_match('/^' . self::CALCULATION_REGEXP_CELLREF . '.*/miu', substr($formula, $index), $match))\n && ($output[$countOutputMinus1]['type'] === 'Cell Reference')\n || (preg_match('/^' . self::CALCULATION_REGEXP_DEFINEDNAME . '.*/miu', substr($formula, $index), $match))\n && ($output[$countOutputMinus1]['type'] === 'Defined Name' || $output[$countOutputMinus1]['type'] === 'Value')\n || (preg_match('/^' . self::CALCULATION_REGEXP_STRUCTURED_REFERENCE . '.*/miu', substr($formula, $index), $match))\n && ($output[$countOutputMinus1]['type'] === Operands\\StructuredReference::NAME || $output[$countOutputMinus1]['type'] === 'Value')\n )\n ) {\n while (self::swapOperands($stack, $opCharacter)) {\n $output[] = $stack->pop(); // Swap operands and higher precedence operators from the stack to the output\n }\n $stack->push('Binary Operator', '∩'); // Put an Intersect Operator on the stack\n $expectingOperator = false;\n }\n }\n }\n\n while (($op = $stack->pop()) !== null) {\n // pop everything off the stack and push onto output\n if ($op['value'] == '(') {\n return $this->raiseFormulaError(\"Formula Error: Expecting ')'\"); // if there are any opening braces on the stack, then braces were unbalanced\n }\n $output[] = $op;\n }\n\n return $output;\n }\n\n /** @param mixed[] $operandData */\n private static function dataTestReference(array &$operandData): mixed\n {\n $operand = $operandData['value'];\n if (($operandData['reference'] === null) && (is_array($operand))) {\n $rKeys = array_keys($operand);\n $rowKey = array_shift($rKeys);\n if (is_array($operand[$rowKey]) === false) {\n $operandData['value'] = $operand[$rowKey];\n\n return $operand[$rowKey];\n }\n\n $cKeys = array_keys(array_keys($operand[$rowKey]));\n $colKey = array_shift($cKeys);\n if (ctype_upper(\"$colKey\")) {\n $operandData['reference'] = $colKey . $rowKey;\n }\n }\n\n return $operand;\n }\n\n private static int $matchIndex8 = 8;\n\n private static int $matchIndex9 = 9;\n\n private static int $matchIndex10 = 10;\n\n /**\n * @param array|false $tokens\n *\n * @return array|false|string\n */\n private function processTokenStack(false|array $tokens, ?string $cellID = null, ?Cell $cell = null)\n {\n if ($tokens === false) {\n return false;\n }\n $phpSpreadsheetFunctions = &self::getFunctionsAddress();\n\n // If we're using cell caching, then $pCell may well be flushed back to the cache (which detaches the parent cell collection),\n // so we store the parent cell collection so that we can re-attach it when necessary\n $pCellWorksheet = ($cell !== null) ? $cell->getWorksheet() : null;\n $originalCoordinate = $cell?->getCoordinate();\n $pCellParent = ($cell !== null) ? $cell->getParent() : null;\n $stack = new Stack($this->branchPruner);\n\n // Stores branches that have been pruned\n $fakedForBranchPruning = [];\n // help us to know when pruning ['branchTestId' => true/false]\n $branchStore = [];\n // Loop through each token in turn\n foreach ($tokens as $tokenIdx => $tokenData) {\n /** @var mixed[] $tokenData */\n $this->processingAnchorArray = false;\n if ($tokenData['type'] === 'Cell Reference' && isset($tokens[$tokenIdx + 1]) && $tokens[$tokenIdx + 1]['type'] === 'Operand Count for Function ANCHORARRAY()') { //* @phpstan-ignore-line\n $this->processingAnchorArray = true;\n }\n $token = $tokenData['value'];\n // Branch pruning: skip useless resolutions\n /** @var ?string */\n $storeKey = $tokenData['storeKey'] ?? null;\n if ($this->branchPruningEnabled && isset($tokenData['onlyIf'])) {\n /** @var string */\n $onlyIfStoreKey = $tokenData['onlyIf'];\n $storeValue = $branchStore[$onlyIfStoreKey] ?? null;\n $storeValueAsBool = ($storeValue === null)\n ? true : (bool) Functions::flattenSingleValue($storeValue);\n if (is_array($storeValue)) {\n $wrappedItem = end($storeValue);\n $storeValue = is_array($wrappedItem) ? end($wrappedItem) : $wrappedItem;\n }\n\n if (\n (isset($storeValue) || $tokenData['reference'] === 'NULL')\n && (!$storeValueAsBool || Information\\ErrorValue::isError($storeValue) || ($storeValue === 'Pruned branch'))\n ) {\n // If branching value is not true, we don't need to compute\n /** @var string $onlyIfStoreKey */\n if (!isset($fakedForBranchPruning['onlyIf-' . $onlyIfStoreKey])) {\n /** @var string $token */\n $stack->push('Value', 'Pruned branch (only if ' . $onlyIfStoreKey . ') ' . $token);\n $fakedForBranchPruning['onlyIf-' . $onlyIfStoreKey] = true;\n }\n\n if (isset($storeKey)) {\n // We are processing an if condition\n // We cascade the pruning to the depending branches\n $branchStore[$storeKey] = 'Pruned branch';\n $fakedForBranchPruning['onlyIfNot-' . $storeKey] = true;\n $fakedForBranchPruning['onlyIf-' . $storeKey] = true;\n }\n\n continue;\n }\n }\n\n if ($this->branchPruningEnabled && isset($tokenData['onlyIfNot'])) {\n /** @var string */\n $onlyIfNotStoreKey = $tokenData['onlyIfNot'];\n $storeValue = $branchStore[$onlyIfNotStoreKey] ?? null;\n $storeValueAsBool = ($storeValue === null)\n ? true : (bool) Functions::flattenSingleValue($storeValue);\n if (is_array($storeValue)) {\n $wrappedItem = end($storeValue);\n $storeValue = is_array($wrappedItem) ? end($wrappedItem) : $wrappedItem;\n }\n\n if (\n (isset($storeValue) || $tokenData['reference'] === 'NULL')\n && ($storeValueAsBool || Information\\ErrorValue::isError($storeValue) || ($storeValue === 'Pruned branch'))\n ) {\n // If branching value is true, we don't need to compute\n if (!isset($fakedForBranchPruning['onlyIfNot-' . $onlyIfNotStoreKey])) {\n /** @var string $token */\n $stack->push('Value', 'Pruned branch (only if not ' . $onlyIfNotStoreKey . ') ' . $token);\n $fakedForBranchPruning['onlyIfNot-' . $onlyIfNotStoreKey] = true;\n }\n\n if (isset($storeKey)) {\n // We are processing an if condition\n // We cascade the pruning to the depending branches\n $branchStore[$storeKey] = 'Pruned branch';\n $fakedForBranchPruning['onlyIfNot-' . $storeKey] = true;\n $fakedForBranchPruning['onlyIf-' . $storeKey] = true;\n }\n\n continue;\n }\n }\n\n if ($token instanceof Operands\\StructuredReference) {\n if ($cell === null) {\n return $this->raiseFormulaError('Structured References must exist in a Cell context');\n }\n\n try {\n $cellRange = $token->parse($cell);\n if (str_contains($cellRange, ':')) {\n $this->debugLog->writeDebugLog('Evaluating Structured Reference %s as Cell Range %s', $token->value(), $cellRange);\n $rangeValue = self::getInstance($cell->getWorksheet()->getParent())->_calculateFormulaValue(\"={$cellRange}\", $cellRange, $cell);\n $stack->push('Value', $rangeValue);\n $this->debugLog->writeDebugLog('Evaluated Structured Reference %s as value %s', $token->value(), $this->showValue($rangeValue));\n } else {\n $this->debugLog->writeDebugLog('Evaluating Structured Reference %s as Cell %s', $token->value(), $cellRange);\n $cellValue = $cell->getWorksheet()->getCell($cellRange)->getCalculatedValue(false);\n $stack->push('Cell Reference', $cellValue, $cellRange);\n $this->debugLog->writeDebugLog('Evaluated Structured Reference %s as value %s', $token->value(), $this->showValue($cellValue));\n }\n } catch (Exception $e) {\n if ($e->getCode() === Exception::CALCULATION_ENGINE_PUSH_TO_STACK) {\n $stack->push('Error', ExcelError::REF(), null);\n $this->debugLog->writeDebugLog('Evaluated Structured Reference %s as error value %s', $token->value(), ExcelError::REF());\n } else {\n return $this->raiseFormulaError($e->getMessage(), $e->getCode(), $e);\n }\n }\n } elseif (!is_numeric($token) && !is_object($token) && isset($token, self::BINARY_OPERATORS[$token])) { //* @phpstan-ignore-line\n // if the token is a binary operator, pop the top two values off the stack, do the operation, and push the result back on the stack\n // We must have two operands, error if we don't\n $operand2Data = $stack->pop();\n if ($operand2Data === null) {\n return $this->raiseFormulaError('Internal error - Operand value missing from stack');\n }\n $operand1Data = $stack->pop();\n if ($operand1Data === null) {\n return $this->raiseFormulaError('Internal error - Operand value missing from stack');\n }\n\n $operand1 = self::dataTestReference($operand1Data);\n $operand2 = self::dataTestReference($operand2Data);\n\n // Log what we're doing\n if ($token == ':') {\n $this->debugLog->writeDebugLog('Evaluating Range %s %s %s', $this->showValue($operand1Data['reference']), $token, $this->showValue($operand2Data['reference']));\n } else {\n $this->debugLog->writeDebugLog('Evaluating %s %s %s', $this->showValue($operand1), $token, $this->showValue($operand2));\n }\n\n // Process the operation in the appropriate manner\n switch ($token) {\n // Comparison (Boolean) Operators\n case '>': // Greater than\n case '<': // Less than\n case '>=': // Greater than or Equal to\n case '<=': // Less than or Equal to\n case '=': // Equality\n case '<>': // Inequality\n $result = $this->executeBinaryComparisonOperation($operand1, $operand2, (string) $token, $stack);\n if (isset($storeKey)) {\n $branchStore[$storeKey] = $result;\n }\n\n break;\n // Binary Operators\n case ':': // Range\n if ($operand1Data['type'] === 'Error') {\n $stack->push($operand1Data['type'], $operand1Data['value'], null);\n\n break;\n }\n if ($operand2Data['type'] === 'Error') {\n $stack->push($operand2Data['type'], $operand2Data['value'], null);\n\n break;\n }\n if ($operand1Data['type'] === 'Defined Name') {\n /** @var array{reference: string} $operand1Data */\n if (preg_match('/$' . self::CALCULATION_REGEXP_DEFINEDNAME . '^/mui', $operand1Data['reference']) !== false && $this->spreadsheet !== null) {\n /** @var string[] $operand1Data */\n $definedName = $this->spreadsheet->getNamedRange($operand1Data['reference']);\n if ($definedName !== null) {\n $operand1Data['reference'] = $operand1Data['value'] = str_replace('$', '', $definedName->getValue());\n }\n }\n }\n /** @var array{reference?: ?string} $operand1Data */\n if (str_contains($operand1Data['reference'] ?? '', '!')) {\n [$sheet1, $operand1Data['reference']] = Worksheet::extractSheetTitle($operand1Data['reference'], true, true);\n } else {\n $sheet1 = ($pCellWorksheet !== null) ? $pCellWorksheet->getTitle() : '';\n }\n //$sheet1 ??= ''; // phpstan level 10 says this is unneeded\n\n /** @var string */\n $op2ref = $operand2Data['reference'];\n [$sheet2, $operand2Data['reference']] = Worksheet::extractSheetTitle($op2ref, true, true);\n if (empty($sheet2)) {\n $sheet2 = $sheet1;\n }\n\n if ($sheet1 === $sheet2) {\n /** @var array{reference: ?string, value: string|string[]} $operand1Data */\n if ($operand1Data['reference'] === null && $cell !== null) {\n if (is_array($operand1Data['value'])) {\n $operand1Data['reference'] = $cell->getCoordinate();\n } elseif ((trim($operand1Data['value']) != '') && (is_numeric($operand1Data['value']))) {\n $operand1Data['reference'] = $cell->getColumn() . $operand1Data['value'];\n } elseif (trim($operand1Data['value']) == '') {\n $operand1Data['reference'] = $cell->getCoordinate();\n } else {\n $operand1Data['reference'] = $operand1Data['value'] . $cell->getRow();\n }\n }\n /** @var array{reference: ?string, value: string|string[]} $operand2Data */\n if ($operand2Data['reference'] === null && $cell !== null) {\n if (is_array($operand2Data['value'])) {\n $operand2Data['reference'] = $cell->getCoordinate();\n } elseif ((trim($operand2Data['value']) != '') && (is_numeric($operand2Data['value']))) {\n $operand2Data['reference'] = $cell->getColumn() . $operand2Data['value'];\n } elseif (trim($operand2Data['value']) == '') {\n $operand2Data['reference'] = $cell->getCoordinate();\n } else {\n $operand2Data['reference'] = $operand2Data['value'] . $cell->getRow();\n }\n }\n\n $oData = array_merge(explode(':', $operand1Data['reference'] ?? ''), explode(':', $operand2Data['reference'] ?? ''));\n $oCol = $oRow = [];\n $breakNeeded = false;\n foreach ($oData as $oDatum) {\n try {\n $oCR = Coordinate::coordinateFromString($oDatum);\n $oCol[] = Coordinate::columnIndexFromString($oCR[0]) - 1;\n $oRow[] = $oCR[1];\n } catch (\\Exception) {\n $stack->push('Error', ExcelError::REF(), null);\n $breakNeeded = true;\n\n break;\n }\n }\n if ($breakNeeded) {\n break;\n }\n $cellRef = Coordinate::stringFromColumnIndex(min($oCol) + 1) . min($oRow) . ':' . Coordinate::stringFromColumnIndex(max($oCol) + 1) . max($oRow); // @phpstan-ignore-line\n if ($pCellParent !== null && $this->spreadsheet !== null) {\n $cellValue = $this->extractCellRange($cellRef, $this->spreadsheet->getSheetByName($sheet1), false);\n } else {\n return $this->raiseFormulaError('Unable to access Cell Reference');\n }\n\n $this->debugLog->writeDebugLog('Evaluation Result is %s', $this->showTypeDetails($cellValue));\n $stack->push('Cell Reference', $cellValue, $cellRef);\n } else {\n $this->debugLog->writeDebugLog('Evaluation Result is a #REF! Error');\n $stack->push('Error', ExcelError::REF(), null);\n }\n\n break;\n case '+': // Addition\n case '-': // Subtraction\n case '*': // Multiplication\n case '/': // Division\n case '^': // Exponential\n $result = $this->executeNumericBinaryOperation($operand1, $operand2, $token, $stack);\n if (isset($storeKey)) {\n $branchStore[$storeKey] = $result;\n }\n\n break;\n case '&': // Concatenation\n // If either of the operands is a matrix, we need to treat them both as matrices\n // (converting the other operand to a matrix if need be); then perform the required\n // matrix operation\n $operand1 = self::boolToString($operand1);\n $operand2 = self::boolToString($operand2);\n if (is_array($operand1) || is_array($operand2)) {\n if (is_string($operand1)) {\n $operand1 = self::unwrapResult($operand1);\n }\n if (is_string($operand2)) {\n $operand2 = self::unwrapResult($operand2);\n }\n // Ensure that both operands are arrays/matrices\n [$rows, $columns] = self::checkMatrixOperands($operand1, $operand2, 2);\n\n for ($row = 0; $row < $rows; ++$row) {\n for ($column = 0; $column < $columns; ++$column) {\n /** @var mixed[][] $operand1 */\n $op1x = self::boolToString($operand1[$row][$column]);\n /** @var mixed[][] $operand2 */\n $op2x = self::boolToString($operand2[$row][$column]);\n if (Information\\ErrorValue::isError($op1x)) {\n // no need to do anything\n } elseif (Information\\ErrorValue::isError($op2x)) {\n $operand1[$row][$column] = $op2x;\n } else {\n /** @var string $op1x */\n /** @var string $op2x */\n $operand1[$row][$column]\n = StringHelper::substring(\n $op1x . $op2x,\n 0,\n DataType::MAX_STRING_LENGTH\n );\n }\n }\n }\n $result = $operand1;\n } else {\n if (Information\\ErrorValue::isError($operand1)) {\n $result = $operand1;\n } elseif (Information\\ErrorValue::isError($operand2)) {\n $result = $operand2;\n } else {\n $result = str_replace('\"\"', self::FORMULA_STRING_QUOTE, self::unwrapResult($operand1) . self::unwrapResult($operand2)); //* @phpstan-ignore-line\n $result = StringHelper::substring(\n $result,\n 0,\n DataType::MAX_STRING_LENGTH\n );\n $result = self::FORMULA_STRING_QUOTE . $result . self::FORMULA_STRING_QUOTE;\n }\n }\n $this->debugLog->writeDebugLog('Evaluation Result is %s', $this->showTypeDetails($result));\n $stack->push('Value', $result);\n\n if (isset($storeKey)) {\n $branchStore[$storeKey] = $result;\n }\n\n break;\n case '∩': // Intersect\n /** @var mixed[][] $operand1 */\n /** @var mixed[][] $operand2 */\n $rowIntersect = array_intersect_key($operand1, $operand2);\n $cellIntersect = $oCol = $oRow = [];\n foreach (array_keys($rowIntersect) as $row) {\n $oRow[] = $row;\n foreach ($rowIntersect[$row] as $col => $data) {\n $oCol[] = Coordinate::columnIndexFromString($col) - 1;\n $cellIntersect[$row] = array_intersect_key($operand1[$row], $operand2[$row]);\n }\n }\n if (count(Functions::flattenArray($cellIntersect)) === 0) {\n $this->debugLog->writeDebugLog('Evaluation Result is %s', $this->showTypeDetails($cellIntersect));\n $stack->push('Error', ExcelError::null(), null);\n } else {\n $cellRef = Coordinate::stringFromColumnIndex(min($oCol) + 1) . min($oRow) . ':' // @phpstan-ignore-line\n . Coordinate::stringFromColumnIndex(max($oCol) + 1) . max($oRow); // @phpstan-ignore-line\n $this->debugLog->writeDebugLog('Evaluation Result is %s', $this->showTypeDetails($cellIntersect));\n $stack->push('Value', $cellIntersect, $cellRef);\n }\n\n break;\n case '∪': // union\n /** @var mixed[][] $operand1 */\n /** @var mixed[][] $operand2 */\n $cellUnion = array_merge($operand1, $operand2);\n $this->debugLog->writeDebugLog('Evaluation Result is %s', $this->showTypeDetails($cellUnion));\n $stack->push('Value', $cellUnion, 'A1');\n\n break;\n }\n } elseif (($token === '~') || ($token === '%')) {\n // if the token is a unary operator, pop one value off the stack, do the operation, and push it back on\n if (($arg = $stack->pop()) === null) {\n return $this->raiseFormulaError('Internal error - Operand value missing from stack');\n }\n $arg = $arg['value'];\n if ($token === '~') {\n $this->debugLog->writeDebugLog('Evaluating Negation of %s', $this->showValue($arg));\n $multiplier = -1;\n } else {\n $this->debugLog->writeDebugLog('Evaluating Percentile of %s', $this->showValue($arg));\n $multiplier = 0.01;\n }\n if (is_array($arg)) {\n $operand2 = $multiplier;\n $result = $arg;\n [$rows, $columns] = self::checkMatrixOperands($result, $operand2, 0);\n for ($row = 0; $row < $rows; ++$row) {\n for ($column = 0; $column < $columns; ++$column) {\n /** @var mixed[][] $result */\n if (self::isNumericOrBool($result[$row][$column])) {\n /** @var float|int|numeric-string */\n $temp = $result[$row][$column];\n $result[$row][$column] = $temp * $multiplier;\n } else {\n $result[$row][$column] = self::makeError($result[$row][$column]);\n }\n }\n }\n\n $this->debugLog->writeDebugLog('Evaluation Result is %s', $this->showTypeDetails($result));\n $stack->push('Value', $result);\n if (isset($storeKey)) {\n $branchStore[$storeKey] = $result;\n }\n } else {\n $this->executeNumericBinaryOperation($multiplier, $arg, '*', $stack);\n }\n } elseif (Preg::isMatch('/^' . self::CALCULATION_REGEXP_CELLREF . '$/i', StringHelper::convertToString($token ?? ''), $matches)) {\n $cellRef = null;\n\n /* Phpstan says matches[8/9/10] is never set,\n and code coverage report seems to confirm.\n regex101.com confirms - only 7 capturing groups.\n My theory is that this code expected regexp to\n match cell *or* cellRange, but it does not\n match the latter. Retain the code for now in case\n we do want to add the range match later.\n Probably delete this block later.\n Until delete happens, turn code coverage off.\n */\n if (isset($matches[self::$matchIndex8])) {\n // @codeCoverageIgnoreStart\n if ($cell === null) {\n // We can't access the range, so return a REF error\n $cellValue = ExcelError::REF();\n } else {\n $cellRef = $matches[6] . $matches[7] . ':' . $matches[self::$matchIndex9] . $matches[self::$matchIndex10];\n $matches[2] = (string) $matches[2];\n if ($matches[2] > '') {\n $matches[2] = trim($matches[2], \"\\\"'\");\n if ((str_contains($matches[2], '[')) || (str_contains($matches[2], ']'))) {\n // It's a Reference to an external spreadsheet (not currently supported)\n return $this->raiseFormulaError('Unable to access External Workbook');\n }\n $matches[2] = trim($matches[2], \"\\\"'\");\n $this->debugLog->writeDebugLog('Evaluating Cell Range %s in worksheet %s', $cellRef, $matches[2]);\n if ($pCellParent !== null && $this->spreadsheet !== null) {\n $cellValue = $this->extractCellRange($cellRef, $this->spreadsheet->getSheetByName($matches[2]), false);\n } else {\n return $this->raiseFormulaError('Unable to access Cell Reference');\n }\n $this->debugLog->writeDebugLog('Evaluation Result for cells %s in worksheet %s is %s', $cellRef, $matches[2], $this->showTypeDetails($cellValue));\n } else {\n $this->debugLog->writeDebugLog('Evaluating Cell Range %s in current worksheet', $cellRef);\n if ($pCellParent !== null) {\n $cellValue = $this->extractCellRange($cellRef, $pCellWorksheet, false);\n } else {\n return $this->raiseFormulaError('Unable to access Cell Reference');\n }\n $this->debugLog->writeDebugLog('Evaluation Result for cells %s is %s', $cellRef, $this->showTypeDetails($cellValue));\n }\n }\n // @codeCoverageIgnoreEnd\n } else {\n if ($cell === null) {\n // We can't access the cell, so return a REF error\n $cellValue = ExcelError::REF();\n } else {\n $cellRef = $matches[6] . $matches[7];\n $matches[2] = (string) $matches[2];\n if ($matches[2] > '') {\n $matches[2] = trim($matches[2], \"\\\"'\");\n if ((str_contains($matches[2], '[')) || (str_contains($matches[2], ']'))) {\n // It's a Reference to an external spreadsheet (not currently supported)\n return $this->raiseFormulaError('Unable to access External Workbook');\n }\n $this->debugLog->writeDebugLog('Evaluating Cell %s in worksheet %s', $cellRef, $matches[2]);\n if ($pCellParent !== null && $this->spreadsheet !== null) {\n $cellSheet = $this->spreadsheet->getSheetByName($matches[2]);\n if ($cellSheet && !$cellSheet->cellExists($cellRef)) {\n try {\n $cellSheet->setCellValue($cellRef, null);\n } catch (SpreadsheetException) {\n // do nothing\n }\n }\n if ($cellSheet && $cellSheet->cellExists($cellRef)) {\n $cellValue = $this->extractCellRange($cellRef, $this->spreadsheet->getSheetByName($matches[2]), false);\n $cell->attach($pCellParent);\n } else {\n $cellRef = ($cellSheet !== null) ? \"'{$matches[2]}'!{$cellRef}\" : $cellRef;\n $cellValue = ($cellSheet !== null) ? null : ExcelError::REF();\n }\n } else {\n return $this->raiseFormulaError('Unable to access Cell Reference');\n }\n $this->debugLog->writeDebugLog('Evaluation Result for cell %s in worksheet %s is %s', $cellRef, $matches[2], $this->showTypeDetails($cellValue));\n } else {\n $this->debugLog->writeDebugLog('Evaluating Cell %s in current worksheet', $cellRef);\n if ($pCellParent !== null && $pCellParent->has($cellRef)) {\n $cellValue = $this->extractCellRange($cellRef, $pCellWorksheet, false);\n $cell->attach($pCellParent);\n } else {\n $cellValue = null;\n }\n $this->debugLog->writeDebugLog('Evaluation Result for cell %s is %s', $cellRef, $this->showTypeDetails($cellValue));\n }\n }\n }\n\n if ($this->getInstanceArrayReturnType() === self::RETURN_ARRAY_AS_ARRAY && !$this->processingAnchorArray && is_array($cellValue)) {\n while (is_array($cellValue)) {\n $cellValue = array_shift($cellValue);\n }\n if (is_string($cellValue)) {\n $cellValue = Preg::replace('/\"/', '\"\"', $cellValue);\n }\n $this->debugLog->writeDebugLog('Scalar Result for cell %s is %s', $cellRef, $this->showTypeDetails($cellValue));\n }\n $this->processingAnchorArray = false;\n $stack->push('Cell Value', $cellValue, $cellRef);\n if (isset($storeKey)) {\n $branchStore[$storeKey] = $cellValue;\n }\n } elseif (preg_match('/^' . self::CALCULATION_REGEXP_FUNCTION . '$/miu', StringHelper::convertToString($token ?? ''), $matches)) {\n // if the token is a function, pop arguments off the stack, hand them to the function, and push the result back on\n if ($cell !== null && $pCellParent !== null) {\n $cell->attach($pCellParent);\n }\n\n $functionName = $matches[1];\n /** @var array $argCount */\n $argCount = $stack->pop();\n $argCount = $argCount['value'];\n if ($functionName !== 'MKMATRIX') {\n $this->debugLog->writeDebugLog('Evaluating Function %s() with %s argument%s', self::localeFunc($functionName), (($argCount == 0) ? 'no' : $argCount), (($argCount == 1) ? '' : 's'));\n }\n if ((isset($phpSpreadsheetFunctions[$functionName])) || (isset(self::$controlFunctions[$functionName]))) { // function\n $passByReference = false;\n $passCellReference = false;\n $functionCall = null;\n if (isset($phpSpreadsheetFunctions[$functionName])) {\n $functionCall = $phpSpreadsheetFunctions[$functionName]['functionCall'];\n $passByReference = isset($phpSpreadsheetFunctions[$functionName]['passByReference']);\n $passCellReference = isset($phpSpreadsheetFunctions[$functionName]['passCellReference']);\n } elseif (isset(self::$controlFunctions[$functionName])) {\n $functionCall = self::$controlFunctions[$functionName]['functionCall'];\n $passByReference = isset(self::$controlFunctions[$functionName]['passByReference']);\n $passCellReference = isset(self::$controlFunctions[$functionName]['passCellReference']);\n }\n\n // get the arguments for this function\n $args = $argArrayVals = [];\n $emptyArguments = [];\n for ($i = 0; $i < $argCount; ++$i) {\n $arg = $stack->pop();\n $a = $argCount - $i - 1;\n if (\n ($passByReference)\n && (isset($phpSpreadsheetFunctions[$functionName]['passByReference'][$a])) //* @phpstan-ignore-line\n && ($phpSpreadsheetFunctions[$functionName]['passByReference'][$a])\n ) {\n /** @var mixed[] $arg */\n if ($arg['reference'] === null) {\n $nextArg = $cellID;\n if ($functionName === 'ISREF' && ($arg['type'] ?? '') === 'Value') {\n if (array_key_exists('value', $arg)) {\n $argValue = $arg['value'];\n if (is_scalar($argValue)) {\n $nextArg = $argValue;\n } elseif (empty($argValue)) {\n $nextArg = '';\n }\n }\n } elseif (($arg['type'] ?? '') === 'Error') {\n $argValue = $arg['value'];\n if (is_scalar($argValue)) {\n $nextArg = $argValue;\n } elseif (empty($argValue)) {\n $nextArg = '';\n }\n }\n $args[] = $nextArg;\n if ($functionName !== 'MKMATRIX') {\n $argArrayVals[] = $this->showValue($cellID);\n }\n } else {\n $args[] = $arg['reference'];\n if ($functionName !== 'MKMATRIX') {\n $argArrayVals[] = $this->showValue($arg['reference']);\n }\n }\n } else {\n /** @var mixed[] $arg */\n if ($arg['type'] === 'Empty Argument' && in_array($functionName, ['MIN', 'MINA', 'MAX', 'MAXA', 'IF'], true)) {\n $emptyArguments[] = false;\n $args[] = $arg['value'] = 0;\n $this->debugLog->writeDebugLog('Empty Argument reevaluated as 0');\n } else {\n $emptyArguments[] = $arg['type'] === 'Empty Argument';\n $args[] = self::unwrapResult($arg['value']);\n }\n if ($functionName !== 'MKMATRIX') {\n $argArrayVals[] = $this->showValue($arg['value']);\n }\n }\n }\n\n // Reverse the order of the arguments\n krsort($args);\n krsort($emptyArguments);\n\n if ($argCount > 0 && is_array($functionCall)) {\n /** @var string[] */\n $functionCallCopy = $functionCall;\n $args = $this->addDefaultArgumentValues($functionCallCopy, $args, $emptyArguments);\n }\n\n if (($passByReference) && ($argCount == 0)) {\n $args[] = $cellID;\n $argArrayVals[] = $this->showValue($cellID);\n }\n\n if ($functionName !== 'MKMATRIX') {\n if ($this->debugLog->getWriteDebugLog()) {\n krsort($argArrayVals);\n $this->debugLog->writeDebugLog('Evaluating %s ( %s )', self::localeFunc($functionName), implode(self::$localeArgumentSeparator . ' ', Functions::flattenArray($argArrayVals)));\n }\n }\n\n // Process the argument with the appropriate function call\n if ($pCellWorksheet !== null && $originalCoordinate !== null) {\n $pCellWorksheet->getCell($originalCoordinate);\n }\n /** @var array|string $functionCall */\n $args = $this->addCellReference($args, $passCellReference, $functionCall, $cell);\n\n if (!is_array($functionCall)) {\n foreach ($args as &$arg) {\n $arg = Functions::flattenSingleValue($arg);\n }\n unset($arg);\n }\n\n /** @var callable $functionCall */\n try {\n $result = call_user_func_array($functionCall, $args);\n } catch (TypeError $e) {\n if (!$this->suppressFormulaErrors) {\n throw $e;\n }\n $result = false;\n }\n if ($functionName !== 'MKMATRIX') {\n $this->debugLog->writeDebugLog('Evaluation Result for %s() function call is %s', self::localeFunc($functionName), $this->showTypeDetails($result));\n }\n $stack->push('Value', self::wrapResult($result));\n if (isset($storeKey)) {\n $branchStore[$storeKey] = $result;\n }\n }\n } else {\n // if the token is a number, boolean, string or an Excel error, push it onto the stack\n /** @var ?string $token */\n if (isset(self::EXCEL_CONSTANTS[strtoupper($token ?? '')])) {\n $excelConstant = strtoupper(\"$token\");\n $stack->push('Constant Value', self::EXCEL_CONSTANTS[$excelConstant]);\n if (isset($storeKey)) {\n $branchStore[$storeKey] = self::EXCEL_CONSTANTS[$excelConstant];\n }\n $this->debugLog->writeDebugLog('Evaluating Constant %s as %s', $excelConstant, $this->showTypeDetails(self::EXCEL_CONSTANTS[$excelConstant]));\n } elseif ((is_numeric($token)) || ($token === null) || (is_bool($token)) || ($token == '') || ($token[0] == self::FORMULA_STRING_QUOTE) || ($token[0] == '#')) { //* @phpstan-ignore-line\n /** @var array{type: string, reference: ?string} $tokenData */\n $stack->push($tokenData['type'], $token, $tokenData['reference']);\n if (isset($storeKey)) {\n $branchStore[$storeKey] = $token;\n }\n } elseif (preg_match('/^' . self::CALCULATION_REGEXP_DEFINEDNAME . '$/miu', $token, $matches)) {\n // if the token is a named range or formula, evaluate it and push the result onto the stack\n $definedName = $matches[6];\n if (str_starts_with($definedName, '_xleta')) {\n return Functions::NOT_YET_IMPLEMENTED;\n }\n if ($cell === null || $pCellWorksheet === null) {\n return $this->raiseFormulaError(\"undefined name '$token'\");\n }\n $specifiedWorksheet = trim($matches[2], \"'\");\n\n $this->debugLog->writeDebugLog('Evaluating Defined Name %s', $definedName);\n $namedRange = DefinedName::resolveName($definedName, $pCellWorksheet, $specifiedWorksheet);\n // If not Defined Name, try as Table.\n if ($namedRange === null && $this->spreadsheet !== null) {\n $table = $this->spreadsheet->getTableByName($definedName);\n if ($table !== null) {\n $tableRange = Coordinate::getRangeBoundaries($table->getRange());\n if ($table->getShowHeaderRow()) {\n ++$tableRange[0][1];\n }\n if ($table->getShowTotalsRow()) {\n --$tableRange[1][1];\n }\n $tableRangeString\n = '$' . $tableRange[0][0]\n . '$' . $tableRange[0][1]\n . ':'\n . '$' . $tableRange[1][0]\n . '$' . $tableRange[1][1];\n $namedRange = new NamedRange($definedName, $table->getWorksheet(), $tableRangeString);\n }\n }\n if ($namedRange === null) {\n $result = ExcelError::NAME();\n $stack->push('Error', $result, null);\n $this->debugLog->writeDebugLog(\"Error $result\");\n } else {\n $result = $this->evaluateDefinedName($cell, $namedRange, $pCellWorksheet, $stack, $specifiedWorksheet !== '');\n }\n\n if (isset($storeKey)) {\n $branchStore[$storeKey] = $result;\n }\n } else {\n return $this->raiseFormulaError(\"undefined name '$token'\");\n }\n }\n }\n // when we're out of tokens, the stack should have a single element, the final result\n if ($stack->count() != 1) {\n return $this->raiseFormulaError('internal error');\n }\n /** @var array|false|string> */\n $output = $stack->pop();\n $output = $output['value'];\n\n return $output;\n }\n\n private function validateBinaryOperand(mixed &$operand, Stack &$stack): bool\n {\n if (is_array($operand)) {\n if ((count($operand, COUNT_RECURSIVE) - count($operand)) == 1) {\n do {\n $operand = array_pop($operand);\n } while (is_array($operand));\n }\n }\n // Numbers, matrices and booleans can pass straight through, as they're already valid\n if (is_string($operand)) {\n // We only need special validations for the operand if it is a string\n // Start by stripping off the quotation marks we use to identify true excel string values internally\n if ($operand > '' && $operand[0] == self::FORMULA_STRING_QUOTE) {\n $operand = StringHelper::convertToString(self::unwrapResult($operand));\n }\n // If the string is a numeric value, we treat it as a numeric, so no further testing\n if (!is_numeric($operand)) {\n // If not a numeric, test to see if the value is an Excel error, and so can't be used in normal binary operations\n if ($operand > '' && $operand[0] == '#') {\n $stack->push('Value', $operand);\n $this->debugLog->writeDebugLog('Evaluation Result is %s', $this->showTypeDetails($operand));\n\n return false;\n } elseif (Engine\\FormattedNumber::convertToNumberIfFormatted($operand) === false) {\n // If not a numeric, a fraction or a percentage, then it's a text string, and so can't be used in mathematical binary operations\n $stack->push('Error', '#VALUE!');\n $this->debugLog->writeDebugLog('Evaluation Result is a %s', $this->showTypeDetails('#VALUE!'));\n\n return false;\n }\n }\n }\n\n // return a true if the value of the operand is one that we can use in normal binary mathematical operations\n return true;\n }\n\n /** @return mixed[] */\n private function executeArrayComparison(mixed $operand1, mixed $operand2, string $operation, Stack &$stack, bool $recursingArrays): array\n {\n $result = [];\n if (!is_array($operand2) && is_array($operand1)) {\n // Operand 1 is an array, Operand 2 is a scalar\n foreach ($operand1 as $x => $operandData) {\n $this->debugLog->writeDebugLog('Evaluating Comparison %s %s %s', $this->showValue($operandData), $operation, $this->showValue($operand2));\n $this->executeBinaryComparisonOperation($operandData, $operand2, $operation, $stack);\n /** @var array $r */\n $r = $stack->pop();\n $result[$x] = $r['value'];\n }\n } elseif (is_array($operand2) && !is_array($operand1)) {\n // Operand 1 is a scalar, Operand 2 is an array\n foreach ($operand2 as $x => $operandData) {\n $this->debugLog->writeDebugLog('Evaluating Comparison %s %s %s', $this->showValue($operand1), $operation, $this->showValue($operandData));\n $this->executeBinaryComparisonOperation($operand1, $operandData, $operation, $stack);\n /** @var array $r */\n $r = $stack->pop();\n $result[$x] = $r['value'];\n }\n } elseif (is_array($operand2) && is_array($operand1)) {\n // Operand 1 and Operand 2 are both arrays\n if (!$recursingArrays) {\n self::checkMatrixOperands($operand1, $operand2, 2);\n }\n foreach ($operand1 as $x => $operandData) {\n $this->debugLog->writeDebugLog('Evaluating Comparison %s %s %s', $this->showValue($operandData), $operation, $this->showValue($operand2[$x]));\n $this->executeBinaryComparisonOperation($operandData, $operand2[$x], $operation, $stack, true);\n /** @var array $r */\n $r = $stack->pop();\n $result[$x] = $r['value'];\n }\n } else {\n throw new Exception('Neither operand is an arra');\n }\n // Log the result details\n $this->debugLog->writeDebugLog('Comparison Evaluation Result is %s', $this->showTypeDetails($result));\n // And push the result onto the stack\n $stack->push('Array', $result);\n\n return $result;\n }\n\n /** @return array|bool|string */\n private function executeBinaryComparisonOperation(mixed $operand1, mixed $operand2, string $operation, Stack &$stack, bool $recursingArrays = false): array|bool|string\n {\n // If we're dealing with matrix operations, we want a matrix result\n if ((is_array($operand1)) || (is_array($operand2))) {\n return $this->executeArrayComparison($operand1, $operand2, $operation, $stack, $recursingArrays);\n }\n\n $result = BinaryComparison::compare($operand1, $operand2, $operation);\n\n // Log the result details\n $this->debugLog->writeDebugLog('Evaluation Result is %s', $this->showTypeDetails($result));\n // And push the result onto the stack\n $stack->push('Value', $result);\n\n return $result;\n }\n\n private function executeNumericBinaryOperation(mixed $operand1, mixed $operand2, string $operation, Stack &$stack): mixed\n {\n // Validate the two operands\n if (\n ($this->validateBinaryOperand($operand1, $stack) === false)\n || ($this->validateBinaryOperand($operand2, $stack) === false)\n ) {\n return false;\n }\n\n if (\n (Functions::getCompatibilityMode() != Functions::COMPATIBILITY_OPENOFFICE)\n && ((is_string($operand1) && !is_numeric($operand1) && $operand1 !== '')\n || (is_string($operand2) && !is_numeric($operand2) && $operand2 !== ''))\n ) {\n $result = ExcelError::VALUE();\n } elseif (is_array($operand1) || is_array($operand2)) {\n // Ensure that both operands are arrays/matrices\n if (is_array($operand1)) {\n foreach ($operand1 as $key => $value) {\n $operand1[$key] = Functions::flattenArray($value);\n }\n }\n if (is_array($operand2)) {\n foreach ($operand2 as $key => $value) {\n $operand2[$key] = Functions::flattenArray($value);\n }\n }\n [$rows, $columns] = self::checkMatrixOperands($operand1, $operand2, 3);\n\n for ($row = 0; $row < $rows; ++$row) {\n for ($column = 0; $column < $columns; ++$column) {\n /** @var mixed[][] $operand1 */\n if (($operand1[$row][$column] ?? null) === null) {\n $operand1[$row][$column] = 0;\n } elseif (!self::isNumericOrBool($operand1[$row][$column])) {\n $operand1[$row][$column] = self::makeError($operand1[$row][$column]);\n\n continue;\n }\n /** @var mixed[][] $operand2 */\n if (($operand2[$row][$column] ?? null) === null) {\n $operand2[$row][$column] = 0;\n } elseif (!self::isNumericOrBool($operand2[$row][$column])) {\n $operand1[$row][$column] = self::makeError($operand2[$row][$column]);\n\n continue;\n }\n /** @var float|int */\n $operand1Val = $operand1[$row][$column];\n /** @var float|int */\n $operand2Val = $operand2[$row][$column];\n switch ($operation) {\n case '+':\n $operand1[$row][$column] = $operand1Val + $operand2Val;\n\n break;\n case '-':\n $operand1[$row][$column] = $operand1Val - $operand2Val;\n\n break;\n case '*':\n $operand1[$row][$column] = $operand1Val * $operand2Val;\n\n break;\n case '/':\n if ($operand2Val == 0) {\n $operand1[$row][$column] = ExcelError::DIV0();\n } else {\n $operand1[$row][$column] = $operand1Val / $operand2Val;\n }\n\n break;\n case '^':\n $operand1[$row][$column] = $operand1Val ** $operand2Val;\n\n break;\n\n default:\n throw new Exception('Unsupported numeric binary operation');\n }\n }\n }\n $result = $operand1;\n } else {\n // If we're dealing with non-matrix operations, execute the necessary operation\n /** @var float|int $operand1 */\n /** @var float|int $operand2 */\n switch ($operation) {\n // Addition\n case '+':\n $result = $operand1 + $operand2;\n\n break;\n // Subtraction\n case '-':\n $result = $operand1 - $operand2;\n\n break;\n // Multiplication\n case '*':\n $result = $operand1 * $operand2;\n\n break;\n // Division\n case '/':\n if ($operand2 == 0) {\n // Trap for Divide by Zero error\n $stack->push('Error', ExcelError::DIV0());\n $this->debugLog->writeDebugLog('Evaluation Result is %s', $this->showTypeDetails(ExcelError::DIV0()));\n\n return false;\n }\n $result = $operand1 / $operand2;\n\n break;\n // Power\n case '^':\n $result = $operand1 ** $operand2;\n\n break;\n\n default:\n throw new Exception('Unsupported numeric binary operation');\n }\n }\n\n // Log the result details\n $this->debugLog->writeDebugLog('Evaluation Result is %s', $this->showTypeDetails($result));\n // And push the result onto the stack\n $stack->push('Value', $result);\n\n return $result;\n }\n\n /**\n * Trigger an error, but nicely, if need be.\n *\n * @return false\n */\n protected function raiseFormulaError(string $errorMessage, int $code = 0, ?Throwable $exception = null): bool\n {\n $this->formulaError = $errorMessage;\n $this->cyclicReferenceStack->clear();\n $suppress = $this->suppressFormulaErrors;\n $suppressed = $suppress ? ' $suppressed' : '';\n $this->debugLog->writeDebugLog(\"Raise Error$suppressed $errorMessage\");\n if (!$suppress) {\n throw new Exception($errorMessage, $code, $exception);\n }\n\n return false;\n }\n\n /**\n * Extract range values.\n *\n * @param string $range String based range representation\n * @param ?Worksheet $worksheet Worksheet\n * @param bool $resetLog Flag indicating whether calculation log should be reset or not\n *\n * @return mixed[] Array of values in range if range contains more than one element. Otherwise, a single value is returned.\n */\n public function extractCellRange(string &$range = 'A1', ?Worksheet $worksheet = null, bool $resetLog = true, bool $createCell = false): array\n {\n // Return value\n /** @var mixed[][] */\n $returnValue = [];\n\n if ($worksheet !== null) {\n $worksheetName = $worksheet->getTitle();\n\n if (str_contains($range, '!')) {\n [$worksheetName, $range] = Worksheet::extractSheetTitle($range, true, true);\n $worksheet = ($this->spreadsheet === null) ? null : $this->spreadsheet->getSheetByName($worksheetName);\n }\n\n // Extract range\n $aReferences = Coordinate::extractAllCellReferencesInRange($range);\n $range = \"'\" . $worksheetName . \"'\" . '!' . $range;\n $currentCol = '';\n $currentRow = 0;\n if (!isset($aReferences[1])) {\n // Single cell in range\n sscanf($aReferences[0], '%[A-Z]%d', $currentCol, $currentRow);\n /** @var string $currentCol */\n /** @var int $currentRow */\n if ($createCell && $worksheet !== null && !$worksheet->cellExists($aReferences[0])) {\n $worksheet->setCellValue($aReferences[0], null);\n }\n if ($worksheet !== null && $worksheet->cellExists($aReferences[0])) {\n $temp = $worksheet->getCell($aReferences[0])->getCalculatedValue($resetLog);\n if ($this->getInstanceArrayReturnType() === self::RETURN_ARRAY_AS_ARRAY) {\n while (is_array($temp)) {\n $temp = array_shift($temp);\n }\n }\n $returnValue[$currentRow][$currentCol] = $temp;\n } else {\n $returnValue[$currentRow][$currentCol] = null;\n }\n } else {\n // Extract cell data for all cells in the range\n foreach ($aReferences as $reference) {\n // Extract range\n sscanf($reference, '%[A-Z]%d', $currentCol, $currentRow);\n /** @var string $currentCol */\n /** @var int $currentRow */\n if ($createCell && $worksheet !== null && !$worksheet->cellExists($reference)) {\n $worksheet->setCellValue($reference, null);\n }\n if ($worksheet !== null && $worksheet->cellExists($reference)) {\n $temp = $worksheet->getCell($reference)->getCalculatedValue($resetLog);\n if ($this->getInstanceArrayReturnType() === self::RETURN_ARRAY_AS_ARRAY) {\n while (is_array($temp)) {\n $temp = array_shift($temp);\n }\n }\n $returnValue[$currentRow][$currentCol] = $temp;\n } else {\n $returnValue[$currentRow][$currentCol] = null;\n }\n }\n }\n }\n\n return $returnValue;\n }\n\n /**\n * Extract range values.\n *\n * @param string $range String based range representation\n * @param null|Worksheet $worksheet Worksheet\n * @param bool $resetLog Flag indicating whether calculation log should be reset or not\n *\n * @return mixed[]|string Array of values in range if range contains more than one element. Otherwise, a single value is returned.\n */\n public function extractNamedRange(string &$range = 'A1', ?Worksheet $worksheet = null, bool $resetLog = true): string|array\n {\n // Return value\n $returnValue = [];\n\n if ($worksheet !== null) {\n if (str_contains($range, '!')) {\n [$worksheetName, $range] = Worksheet::extractSheetTitle($range, true, true);\n $worksheet = ($this->spreadsheet === null) ? null : $this->spreadsheet->getSheetByName($worksheetName);\n }\n\n // Named range?\n $namedRange = ($worksheet === null) ? null : DefinedName::resolveName($range, $worksheet);\n if ($namedRange === null) {\n return ExcelError::REF();\n }\n\n $worksheet = $namedRange->getWorksheet();\n $range = $namedRange->getValue();\n $splitRange = Coordinate::splitRange($range);\n // Convert row and column references\n if ($worksheet !== null && ctype_alpha($splitRange[0][0])) {\n $range = $splitRange[0][0] . '1:' . $splitRange[0][1] . $worksheet->getHighestRow();\n } elseif ($worksheet !== null && ctype_digit($splitRange[0][0])) {\n $range = 'A' . $splitRange[0][0] . ':' . $worksheet->getHighestColumn() . $splitRange[0][1];\n }\n\n // Extract range\n $aReferences = Coordinate::extractAllCellReferencesInRange($range);\n if (!isset($aReferences[1])) {\n // Single cell (or single column or row) in range\n [$currentCol, $currentRow] = Coordinate::coordinateFromString($aReferences[0]);\n /** @var mixed[][] $returnValue */\n if ($worksheet !== null && $worksheet->cellExists($aReferences[0])) {\n $returnValue[$currentRow][$currentCol] = $worksheet->getCell($aReferences[0])->getCalculatedValue($resetLog);\n } else {\n $returnValue[$currentRow][$currentCol] = null;\n }\n } else {\n // Extract cell data for all cells in the range\n foreach ($aReferences as $reference) {\n // Extract range\n [$currentCol, $currentRow] = Coordinate::coordinateFromString($reference);\n if ($worksheet !== null && $worksheet->cellExists($reference)) {\n $returnValue[$currentRow][$currentCol] = $worksheet->getCell($reference)->getCalculatedValue($resetLog);\n } else {\n $returnValue[$currentRow][$currentCol] = null;\n }\n }\n }\n }\n\n return $returnValue;\n }\n\n /**\n * Is a specific function implemented?\n *\n * @param string $function Function Name\n */\n public function isImplemented(string $function): bool\n {\n $function = strtoupper($function);\n $phpSpreadsheetFunctions = &self::getFunctionsAddress();\n $notImplemented = !isset($phpSpreadsheetFunctions[$function]) || (is_array($phpSpreadsheetFunctions[$function]['functionCall']) && $phpSpreadsheetFunctions[$function]['functionCall'][1] === 'DUMMY');\n\n return !$notImplemented;\n }\n\n /**\n * Get a list of implemented Excel function names.\n *\n * @return string[]\n */\n public function getImplementedFunctionNames(): array\n {\n $returnValue = [];\n $phpSpreadsheetFunctions = &self::getFunctionsAddress();\n foreach ($phpSpreadsheetFunctions as $functionName => $function) {\n if ($this->isImplemented($functionName)) {\n $returnValue[] = $functionName;\n }\n }\n\n return $returnValue;\n }\n\n /**\n * @param string[] $functionCall\n * @param mixed[] $args\n * @param mixed[] $emptyArguments\n *\n * @return mixed[]\n */\n private function addDefaultArgumentValues(array $functionCall, array $args, array $emptyArguments): array\n {\n $reflector = new ReflectionMethod($functionCall[0], $functionCall[1]);\n $methodArguments = $reflector->getParameters();\n\n if (count($methodArguments) > 0) {\n // Apply any defaults for empty argument values\n foreach ($emptyArguments as $argumentId => $isArgumentEmpty) {\n if ($isArgumentEmpty === true) {\n $reflectedArgumentId = count($args) - (int) $argumentId - 1;\n if (\n !array_key_exists($reflectedArgumentId, $methodArguments)\n || $methodArguments[$reflectedArgumentId]->isVariadic()\n ) {\n break;\n }\n\n $args[$argumentId] = $this->getArgumentDefaultValue($methodArguments[$reflectedArgumentId]);\n }\n }\n }\n\n return $args;\n }\n\n private function getArgumentDefaultValue(ReflectionParameter $methodArgument): mixed\n {\n $defaultValue = null;\n\n if ($methodArgument->isDefaultValueAvailable()) {\n $defaultValue = $methodArgument->getDefaultValue();\n if ($methodArgument->isDefaultValueConstant()) {\n $constantName = $methodArgument->getDefaultValueConstantName() ?? '';\n // read constant value\n if (str_contains($constantName, '::')) {\n [$className, $constantName] = explode('::', $constantName);\n /** @var class-string $className */\n $constantReflector = new ReflectionClassConstant($className, $constantName);\n\n return $constantReflector->getValue();\n }\n\n return constant($constantName);\n }\n }\n\n return $defaultValue;\n }\n\n /**\n * Add cell reference if needed while making sure that it is the last argument.\n *\n * @param mixed[] $args\n * @param string|string[] $functionCall\n *\n * @return mixed[]\n */\n private function addCellReference(array $args, bool $passCellReference, array|string $functionCall, ?Cell $cell = null): array\n {\n if ($passCellReference) {\n if (is_array($functionCall)) {\n $className = $functionCall[0];\n $methodName = $functionCall[1];\n\n $reflectionMethod = new ReflectionMethod($className, $methodName);\n $argumentCount = count($reflectionMethod->getParameters());\n while (count($args) < $argumentCount - 1) {\n $args[] = null;\n }\n }\n\n $args[] = $cell;\n }\n\n return $args;\n }\n\n private function evaluateDefinedName(Cell $cell, DefinedName $namedRange, Worksheet $cellWorksheet, Stack $stack, bool $ignoreScope = false): mixed\n {\n $definedNameScope = $namedRange->getScope();\n if ($definedNameScope !== null && $definedNameScope !== $cellWorksheet && !$ignoreScope) {\n // The defined name isn't in our current scope, so #REF\n $result = ExcelError::REF();\n $stack->push('Error', $result, $namedRange->getName());\n\n return $result;\n }\n\n $definedNameValue = $namedRange->getValue();\n $definedNameType = $namedRange->isFormula() ? 'Formula' : 'Range';\n if ($definedNameType === 'Range') {\n if (Preg::isMatch('/^(.*!)?(.*)$/', $definedNameValue, $matches)) {\n $matches2 = Preg::replace(\n ['/ +/', '/,/'],\n [' ∩ ', ' ∪ '],\n trim($matches[2])\n );\n $definedNameValue = $matches[1] . $matches2;\n }\n }\n $definedNameWorksheet = $namedRange->getWorksheet();\n\n if ($definedNameValue[0] !== '=') {\n $definedNameValue = '=' . $definedNameValue;\n }\n\n $this->debugLog->writeDebugLog('Defined Name is a %s with a value of %s', $definedNameType, $definedNameValue);\n\n $originalCoordinate = $cell->getCoordinate();\n $recursiveCalculationCell = ($definedNameType !== 'Formula' && $definedNameWorksheet !== null && $definedNameWorksheet !== $cellWorksheet)\n ? $definedNameWorksheet->getCell('A1')\n : $cell;\n $recursiveCalculationCellAddress = $recursiveCalculationCell->getCoordinate();\n\n // Adjust relative references in ranges and formulae so that we execute the calculation for the correct rows and columns\n $definedNameValue = ReferenceHelper::getInstance()\n ->updateFormulaReferencesAnyWorksheet(\n $definedNameValue,\n Coordinate::columnIndexFromString(\n $cell->getColumn()\n ) - 1,\n $cell->getRow() - 1\n );\n\n $this->debugLog->writeDebugLog('Value adjusted for relative references is %s', $definedNameValue);\n\n $recursiveCalculator = new self($this->spreadsheet);\n $recursiveCalculator->getDebugLog()->setWriteDebugLog($this->getDebugLog()->getWriteDebugLog());\n $recursiveCalculator->getDebugLog()->setEchoDebugLog($this->getDebugLog()->getEchoDebugLog());\n $result = $recursiveCalculator->_calculateFormulaValue($definedNameValue, $recursiveCalculationCellAddress, $recursiveCalculationCell, true);\n $cellWorksheet->getCell($originalCoordinate);\n\n if ($this->getDebugLog()->getWriteDebugLog()) {\n $this->debugLog->mergeDebugLog(array_slice($recursiveCalculator->getDebugLog()->getLog(), 3));\n $this->debugLog->writeDebugLog('Evaluation Result for Named %s %s is %s', $definedNameType, $namedRange->getName(), $this->showTypeDetails($result));\n }\n\n $y = $namedRange->getWorksheet()?->getTitle();\n $x = $namedRange->getLocalOnly();\n if ($x && $y !== null) {\n $stack->push('Defined Name', $result, \"'$y'!\" . $namedRange->getName());\n } else {\n $stack->push('Defined Name', $result, $namedRange->getName());\n }\n\n return $result;\n }\n\n public function setSuppressFormulaErrors(bool $suppressFormulaErrors): self\n {\n $this->suppressFormulaErrors = $suppressFormulaErrors;\n\n return $this;\n }\n\n public function getSuppressFormulaErrors(): bool\n {\n return $this->suppressFormulaErrors;\n }\n\n public static function boolToString(mixed $operand1): mixed\n {\n if (is_bool($operand1)) {\n $operand1 = ($operand1) ? self::$localeBoolean['TRUE'] : self::$localeBoolean['FALSE'];\n } elseif ($operand1 === null) {\n $operand1 = '';\n }\n\n return $operand1;\n }\n\n private static function isNumericOrBool(mixed $operand): bool\n {\n return is_numeric($operand) || is_bool($operand);\n }\n\n private static function makeError(mixed $operand = ''): string\n {\n return (is_string($operand) && Information\\ErrorValue::isError($operand)) ? $operand : ExcelError::VALUE();\n }\n\n private static function swapOperands(Stack $stack, string $opCharacter): bool\n {\n $retVal = false;\n if ($stack->count() > 0) {\n $o2 = $stack->last();\n if ($o2) {\n /** @var array{value: string} $o2 */\n if (isset(self::CALCULATION_OPERATORS[$o2['value']])) {\n $retVal = (self::OPERATOR_PRECEDENCE[$opCharacter] ?? 0) <= self::OPERATOR_PRECEDENCE[$o2['value']];\n }\n }\n }\n\n return $retVal;\n }\n\n public function getSpreadsheet(): ?Spreadsheet\n {\n return $this->spreadsheet;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/CalculationBase.php",
"content": "\n */\n public static function getFunctions(): array\n {\n return FunctionArray::$phpSpreadsheetFunctions;\n }\n\n /**\n * Get address of list of all implemented functions as an array of function objects.\n *\n * @return array>\n */\n protected static function &getFunctionsAddress(): array\n {\n return FunctionArray::$phpSpreadsheetFunctions;\n }\n\n /**\n * @param array{category: string, functionCall: string|string[], argumentCount: string, passCellReference?: bool, passByReference?: bool[], custom?: bool} $value\n */\n public static function addFunction(string $key, array $value): bool\n {\n $key = strtoupper($key);\n if (\n array_key_exists($key, FunctionArray::$phpSpreadsheetFunctions)\n && !self::isDummy($key)\n ) {\n return false;\n }\n $value['custom'] = true;\n FunctionArray::$phpSpreadsheetFunctions[$key] = $value;\n\n return true;\n }\n\n private static function isDummy(string $key): bool\n {\n // key is already known to exist\n $functionCall = FunctionArray::$phpSpreadsheetFunctions[$key]['functionCall'] ?? null;\n if (!is_array($functionCall)) {\n return false;\n }\n if (($functionCall[1] ?? '') !== 'DUMMY') {\n return false;\n }\n\n return true;\n }\n\n public static function removeFunction(string $key): bool\n {\n $key = strtoupper($key);\n if (array_key_exists($key, FunctionArray::$phpSpreadsheetFunctions)) {\n if (FunctionArray::$phpSpreadsheetFunctions[$key]['custom'] ?? false) {\n unset(FunctionArray::$phpSpreadsheetFunctions[$key]);\n\n return true;\n }\n }\n\n return false;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/CalculationLocale.php",
"content": "\n */\n protected static array $localeBoolean = [\n 'TRUE' => 'TRUE',\n 'FALSE' => 'FALSE',\n 'NULL' => 'NULL',\n ];\n\n /** @var array> */\n protected static array $falseTrueArray = [];\n\n public static function getLocaleBoolean(string $index): string\n {\n return self::$localeBoolean[$index];\n }\n\n protected static function loadLocales(): void\n {\n $localeFileDirectory = __DIR__ . '/locale/';\n $localeFileNames = glob($localeFileDirectory . '*', GLOB_ONLYDIR) ?: [];\n foreach ($localeFileNames as $filename) {\n $filename = substr($filename, strlen($localeFileDirectory));\n if ($filename != 'en') {\n self::$validLocaleLanguages[] = $filename;\n $subdirs = glob(\"$localeFileDirectory$filename/*\", GLOB_ONLYDIR) ?: [];\n foreach ($subdirs as $subdir) {\n $subdirx = basename($subdir);\n self::$validLocaleLanguages[] = \"{$filename}_{$subdirx}\";\n }\n }\n }\n }\n\n /**\n * Return the locale-specific translation of TRUE.\n *\n * @return string locale-specific translation of TRUE\n */\n public static function getTRUE(): string\n {\n return self::$localeBoolean['TRUE'];\n }\n\n /**\n * Return the locale-specific translation of FALSE.\n *\n * @return string locale-specific translation of FALSE\n */\n public static function getFALSE(): string\n {\n return self::$localeBoolean['FALSE'];\n }\n\n /**\n * Get the currently defined locale code.\n */\n public function getLocale(): string\n {\n return self::$localeLanguage;\n }\n\n protected function getLocaleFile(string $localeDir, string $locale, string $language, string $file): string\n {\n $localeFileName = $localeDir . str_replace('_', DIRECTORY_SEPARATOR, $locale)\n . DIRECTORY_SEPARATOR . $file;\n if (!file_exists($localeFileName)) {\n // If there isn't a locale specific file, look for a language specific file\n $localeFileName = $localeDir . $language . DIRECTORY_SEPARATOR . $file;\n if (!file_exists($localeFileName)) {\n throw new Exception('Locale file not found');\n }\n }\n\n return $localeFileName;\n }\n\n /** @return array> */\n public function getFalseTrueArray(): array\n {\n if (!empty(self::$falseTrueArray)) {\n return self::$falseTrueArray;\n }\n if (count(self::$validLocaleLanguages) == 1) {\n self::loadLocales();\n }\n $falseTrueArray = [['FALSE'], ['TRUE']];\n foreach (self::$validLocaleLanguages as $language) {\n if (str_starts_with($language, 'en')) {\n continue;\n }\n $locale = $language;\n if (str_contains($locale, '_')) {\n [$language] = explode('_', $locale);\n }\n $localeDir = implode(DIRECTORY_SEPARATOR, [__DIR__, 'locale', null]);\n\n try {\n $functionNamesFile = $this->getLocaleFile($localeDir, $locale, $language, 'functions');\n } catch (Exception $e) {\n continue;\n }\n // Retrieve the list of locale or language specific function names\n $localeFunctions = file($functionNamesFile, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES) ?: [];\n foreach ($localeFunctions as $localeFunction) {\n [$localeFunction] = explode('##', $localeFunction); // Strip out comments\n if (str_contains($localeFunction, '=')) {\n [$fName, $lfName] = array_map('trim', explode('=', $localeFunction));\n if ($fName === 'FALSE') {\n $falseTrueArray[0][] = $lfName;\n } elseif ($fName === 'TRUE') {\n $falseTrueArray[1][] = $lfName;\n }\n }\n }\n }\n self::$falseTrueArray = $falseTrueArray;\n\n return $falseTrueArray;\n }\n\n /**\n * Set the locale code.\n *\n * @param string $locale The locale to use for formula translation, eg: 'en_us'\n */\n public function setLocale(string $locale): bool\n {\n // Identify our locale and language\n $language = $locale = strtolower($locale);\n if (str_contains($locale, '_')) {\n [$language] = explode('_', $locale);\n }\n if (count(self::$validLocaleLanguages) == 1) {\n self::loadLocales();\n }\n\n // Test whether we have any language data for this language (any locale)\n if (in_array($language, self::$validLocaleLanguages, true)) {\n // initialise language/locale settings\n self::$localeFunctions = [];\n self::$localeArgumentSeparator = ',';\n self::$localeBoolean = ['TRUE' => 'TRUE', 'FALSE' => 'FALSE', 'NULL' => 'NULL'];\n\n // Default is US English, if user isn't requesting US english, then read the necessary data from the locale files\n if ($locale !== 'en_us') {\n $localeDir = implode(DIRECTORY_SEPARATOR, [__DIR__, 'locale', null]);\n\n // Search for a file with a list of function names for locale\n try {\n $functionNamesFile = $this->getLocaleFile($localeDir, $locale, $language, 'functions');\n } catch (Exception $e) {\n return false;\n }\n\n // Retrieve the list of locale or language specific function names\n $localeFunctions = file($functionNamesFile, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES) ?: [];\n $phpSpreadsheetFunctions = &self::getFunctionsAddress();\n foreach ($localeFunctions as $localeFunction) {\n [$localeFunction] = explode('##', $localeFunction); // Strip out comments\n if (str_contains($localeFunction, '=')) {\n [$fName, $lfName] = array_map('trim', explode('=', $localeFunction));\n if ((str_starts_with($fName, '*') || isset($phpSpreadsheetFunctions[$fName])) && ($lfName != '') && ($fName != $lfName)) {\n self::$localeFunctions[$fName] = $lfName;\n }\n }\n }\n // Default the TRUE and FALSE constants to the locale names of the TRUE() and FALSE() functions\n if (isset(self::$localeFunctions['TRUE'])) {\n self::$localeBoolean['TRUE'] = self::$localeFunctions['TRUE'];\n }\n if (isset(self::$localeFunctions['FALSE'])) {\n self::$localeBoolean['FALSE'] = self::$localeFunctions['FALSE'];\n }\n\n try {\n $configFile = $this->getLocaleFile($localeDir, $locale, $language, 'config');\n } catch (Exception) {\n return false;\n }\n\n $localeSettings = file($configFile, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES) ?: [];\n foreach ($localeSettings as $localeSetting) {\n [$localeSetting] = explode('##', $localeSetting); // Strip out comments\n if (str_contains($localeSetting, '=')) {\n [$settingName, $settingValue] = array_map('trim', explode('=', $localeSetting));\n $settingName = strtoupper($settingName);\n if ($settingValue !== '') {\n switch ($settingName) {\n case 'ARGUMENTSEPARATOR':\n self::$localeArgumentSeparator = $settingValue;\n\n break;\n }\n }\n }\n }\n }\n\n self::$functionReplaceFromExcel = self::$functionReplaceToExcel\n = self::$functionReplaceFromLocale = self::$functionReplaceToLocale = null;\n self::$localeLanguage = $locale;\n\n return true;\n }\n\n return false;\n }\n\n public static function translateSeparator(\n string $fromSeparator,\n string $toSeparator,\n string $formula,\n int &$inBracesLevel,\n string $openBrace = self::FORMULA_OPEN_FUNCTION_BRACE,\n string $closeBrace = self::FORMULA_CLOSE_FUNCTION_BRACE\n ): string {\n $strlen = mb_strlen($formula);\n for ($i = 0; $i < $strlen; ++$i) {\n $chr = mb_substr($formula, $i, 1);\n switch ($chr) {\n case $openBrace:\n ++$inBracesLevel;\n\n break;\n case $closeBrace:\n --$inBracesLevel;\n\n break;\n case $fromSeparator:\n if ($inBracesLevel > 0) {\n $formula = mb_substr($formula, 0, $i) . $toSeparator . mb_substr($formula, $i + 1);\n }\n }\n }\n\n return $formula;\n }\n\n /**\n * @param string[] $from\n * @param string[] $to\n */\n protected static function translateFormulaBlock(\n array $from,\n array $to,\n string $formula,\n int &$inFunctionBracesLevel,\n int &$inMatrixBracesLevel,\n string $fromSeparator,\n string $toSeparator\n ): string {\n // Function Names\n $formula = (string) preg_replace($from, $to, $formula);\n\n // Temporarily adjust matrix separators so that they won't be confused with function arguments\n $formula = self::translateSeparator(';', '|', $formula, $inMatrixBracesLevel, self::FORMULA_OPEN_MATRIX_BRACE, self::FORMULA_CLOSE_MATRIX_BRACE);\n $formula = self::translateSeparator(',', '!', $formula, $inMatrixBracesLevel, self::FORMULA_OPEN_MATRIX_BRACE, self::FORMULA_CLOSE_MATRIX_BRACE);\n // Function Argument Separators\n $formula = self::translateSeparator($fromSeparator, $toSeparator, $formula, $inFunctionBracesLevel);\n // Restore matrix separators\n $formula = self::translateSeparator('|', ';', $formula, $inMatrixBracesLevel, self::FORMULA_OPEN_MATRIX_BRACE, self::FORMULA_CLOSE_MATRIX_BRACE);\n $formula = self::translateSeparator('!', ',', $formula, $inMatrixBracesLevel, self::FORMULA_OPEN_MATRIX_BRACE, self::FORMULA_CLOSE_MATRIX_BRACE);\n\n return $formula;\n }\n\n /**\n * @param string[] $from\n * @param string[] $to\n */\n protected static function translateFormula(array $from, array $to, string $formula, string $fromSeparator, string $toSeparator): string\n {\n // Convert any Excel function names and constant names to the required language;\n // and adjust function argument separators\n if (self::$localeLanguage !== 'en_us') {\n $inFunctionBracesLevel = 0;\n $inMatrixBracesLevel = 0;\n // If there is the possibility of separators within a quoted string, then we treat them as literals\n if (str_contains($formula, self::FORMULA_STRING_QUOTE)) {\n // So instead we skip replacing in any quoted strings by only replacing in every other array element\n // after we've exploded the formula\n $temp = explode(self::FORMULA_STRING_QUOTE, $formula);\n $notWithinQuotes = false;\n foreach ($temp as &$value) {\n // Only adjust in alternating array entries\n $notWithinQuotes = $notWithinQuotes === false;\n if ($notWithinQuotes === true) {\n $value = self::translateFormulaBlock($from, $to, $value, $inFunctionBracesLevel, $inMatrixBracesLevel, $fromSeparator, $toSeparator);\n }\n }\n unset($value);\n // Then rebuild the formula string\n $formula = implode(self::FORMULA_STRING_QUOTE, $temp);\n } else {\n // If there's no quoted strings, then we do a simple count/replace\n $formula = self::translateFormulaBlock($from, $to, $formula, $inFunctionBracesLevel, $inMatrixBracesLevel, $fromSeparator, $toSeparator);\n }\n }\n\n return $formula;\n }\n\n /** @var null|string[] */\n private static ?array $functionReplaceFromExcel;\n\n /** @var null|string[] */\n private static ?array $functionReplaceToLocale;\n\n public function translateFormulaToLocale(string $formula): string\n {\n $formula = preg_replace(self::CALCULATION_REGEXP_STRIP_XLFN_XLWS, '', $formula) ?? '';\n // Build list of function names and constants for translation\n if (self::$functionReplaceFromExcel === null) {\n self::$functionReplaceFromExcel = [];\n foreach (array_keys(self::$localeFunctions) as $excelFunctionName) {\n self::$functionReplaceFromExcel[] = '/(@?[^\\w\\.])' . preg_quote($excelFunctionName, '/') . '([\\s]*\\()/ui';\n }\n foreach (array_keys(self::$localeBoolean) as $excelBoolean) {\n self::$functionReplaceFromExcel[] = '/(@?[^\\w\\.])' . preg_quote($excelBoolean, '/') . '([^\\w\\.])/ui';\n }\n }\n\n if (self::$functionReplaceToLocale === null) {\n self::$functionReplaceToLocale = [];\n foreach (self::$localeFunctions as $localeFunctionName) {\n self::$functionReplaceToLocale[] = '$1' . trim($localeFunctionName) . '$2';\n }\n foreach (self::$localeBoolean as $localeBoolean) {\n self::$functionReplaceToLocale[] = '$1' . trim($localeBoolean) . '$2';\n }\n }\n\n return self::translateFormula(\n self::$functionReplaceFromExcel,\n self::$functionReplaceToLocale,\n $formula,\n ',',\n self::$localeArgumentSeparator\n );\n }\n\n /** @var null|string[] */\n protected static ?array $functionReplaceFromLocale;\n\n /** @var null|string[] */\n protected static ?array $functionReplaceToExcel;\n\n public function translateFormulaToEnglish(string $formula): string\n {\n if (self::$functionReplaceFromLocale === null) {\n self::$functionReplaceFromLocale = [];\n foreach (self::$localeFunctions as $localeFunctionName) {\n self::$functionReplaceFromLocale[] = '/(@?[^\\w\\.])' . preg_quote($localeFunctionName, '/') . '([\\s]*\\()/ui';\n }\n foreach (self::$localeBoolean as $excelBoolean) {\n self::$functionReplaceFromLocale[] = '/(@?[^\\w\\.])' . preg_quote($excelBoolean, '/') . '([^\\w\\.])/ui';\n }\n }\n\n if (self::$functionReplaceToExcel === null) {\n self::$functionReplaceToExcel = [];\n foreach (array_keys(self::$localeFunctions) as $excelFunctionName) {\n self::$functionReplaceToExcel[] = '$1' . trim($excelFunctionName) . '$2';\n }\n foreach (array_keys(self::$localeBoolean) as $excelBoolean) {\n self::$functionReplaceToExcel[] = '$1' . trim($excelBoolean) . '$2';\n }\n }\n\n return self::translateFormula(self::$functionReplaceFromLocale, self::$functionReplaceToExcel, $formula, self::$localeArgumentSeparator, ',');\n }\n\n public static function localeFunc(string $function): string\n {\n if (self::$localeLanguage !== 'en_us') {\n $functionName = trim($function, '(');\n if (isset(self::$localeFunctions[$functionName])) {\n $brace = ($functionName != $function);\n $function = self::$localeFunctions[$functionName];\n if ($brace) {\n $function .= '(';\n }\n }\n }\n\n return $function;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/CalculationParserOnly.php",
"content": "|int|string $field Indicates which column is used in the function. Enter the\n * column label enclosed between double quotation marks, such as\n * \"Age\" or \"Yield,\" or a number (without quotation marks) that\n * represents the position of the column within the list: 1 for\n * the first column, 2 for the second column, and so on.\n * @param mixed[][] $criteria The range of cells that contains the conditions you specify.\n * You can use any range for the criteria argument, as long as it\n * includes at least one column label and at least one cell below\n * the column label in which you specify a condition for the\n * column.\n */\n public static function evaluate(array $database, array|null|int|string $field, array $criteria): string|int|float\n {\n $field = self::fieldExtract($database, $field);\n if ($field === null) {\n return ExcelError::VALUE();\n }\n\n return Averages::average(\n self::getFilteredColumn($database, $field, $criteria)\n );\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Database/DCount.php",
"content": "|int|string $field Indicates which column is used in the function. Enter the\n * column label enclosed between double quotation marks, such as\n * \"Age\" or \"Yield,\" or a number (without quotation marks) that\n * represents the position of the column within the list: 1 for\n * the first column, 2 for the second column, and so on.\n * @param mixed[][] $criteria The range of cells that contains the conditions you specify.\n * You can use any range for the criteria argument, as long as it\n * includes at least one column label and at least one cell below\n * the column label in which you specify a condition for the\n * column.\n */\n public static function evaluate(array $database, array|null|int|string $field, array $criteria, bool $returnError = true): string|int\n {\n $field = self::fieldExtract($database, $field);\n if ($returnError && $field === null) {\n return ExcelError::VALUE();\n }\n\n return Counts::COUNT(\n self::getFilteredColumn($database, $field, $criteria)\n );\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Database/DCountA.php",
"content": "|int|string $field Indicates which column is used in the function. Enter the\n * column label enclosed between double quotation marks, such as\n * \"Age\" or \"Yield,\" or a number (without quotation marks) that\n * represents the position of the column within the list: 1 for\n * the first column, 2 for the second column, and so on.\n * @param mixed[][] $criteria The range of cells that contains the conditions you specify.\n * You can use any range for the criteria argument, as long as it\n * includes at least one column label and at least one cell below\n * the column label in which you specify a condition for the\n * column.\n */\n public static function evaluate(array $database, array|null|int|string $field, array $criteria): string|int\n {\n $field = self::fieldExtract($database, $field);\n if ($field === null) {\n return ExcelError::VALUE();\n }\n\n return Counts::COUNTA(\n self::getFilteredColumn($database, $field, $criteria)\n );\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Database/DGet.php",
"content": "|int|string $field Indicates which column is used in the function. Enter the\n * column label enclosed between double quotation marks, such as\n * \"Age\" or \"Yield,\" or a number (without quotation marks) that\n * represents the position of the column within the list: 1 for\n * the first column, 2 for the second column, and so on.\n * @param mixed[][] $criteria The range of cells that contains the conditions you specify.\n * You can use any range for the criteria argument, as long as it\n * includes at least one column label and at least one cell below\n * the column label in which you specify a condition for the\n * column.\n */\n public static function evaluate(array $database, array|null|int|string $field, array $criteria): null|float|int|string\n {\n $field = self::fieldExtract($database, $field);\n if ($field === null) {\n return ExcelError::VALUE();\n }\n\n $columnData = self::getFilteredColumn($database, $field, $criteria);\n if (count($columnData) > 1) {\n return ExcelError::NAN();\n }\n\n /** @var array */\n $row = array_pop($columnData);\n\n return array_pop($row);\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Database/DMax.php",
"content": "|int|string $field Indicates which column is used in the function. Enter the\n * column label enclosed between double quotation marks, such as\n * \"Age\" or \"Yield,\" or a number (without quotation marks) that\n * represents the position of the column within the list: 1 for\n * the first column, 2 for the second column, and so on.\n * @param mixed[][] $criteria The range of cells that contains the conditions you specify.\n * You can use any range for the criteria argument, as long as it\n * includes at least one column label and at least one cell below\n * the column label in which you specify a condition for the\n * column.\n */\n public static function evaluate(array $database, array|null|int|string $field, array $criteria, bool $returnError = true): null|float|string\n {\n $field = self::fieldExtract($database, $field);\n if ($field === null) {\n return $returnError ? ExcelError::VALUE() : null;\n }\n\n return Maximum::max(\n self::getFilteredColumn($database, $field, $criteria)\n );\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Database/DMin.php",
"content": "|int|string $field Indicates which column is used in the function. Enter the\n * column label enclosed between double quotation marks, such as\n * \"Age\" or \"Yield,\" or a number (without quotation marks) that\n * represents the position of the column within the list: 1 for\n * the first column, 2 for the second column, and so on.\n * @param mixed[][] $criteria The range of cells that contains the conditions you specify.\n * You can use any range for the criteria argument, as long as it\n * includes at least one column label and at least one cell below\n * the column label in which you specify a condition for the\n * column.\n */\n public static function evaluate(array $database, array|null|int|string $field, array $criteria, bool $returnError = true): float|string|null\n {\n $field = self::fieldExtract($database, $field);\n if ($field === null) {\n return $returnError ? ExcelError::VALUE() : null;\n }\n\n return Minimum::min(\n self::getFilteredColumn($database, $field, $criteria)\n );\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Database/DProduct.php",
"content": "|int|string $field Indicates which column is used in the function. Enter the\n * column label enclosed between double quotation marks, such as\n * \"Age\" or \"Yield,\" or a number (without quotation marks) that\n * represents the position of the column within the list: 1 for\n * the first column, 2 for the second column, and so on.\n * @param mixed[][] $criteria The range of cells that contains the conditions you specify.\n * You can use any range for the criteria argument, as long as it\n * includes at least one column label and at least one cell below\n * the column label in which you specify a condition for the\n * column.\n */\n public static function evaluate(array $database, array|null|int|string $field, array $criteria): string|float\n {\n $field = self::fieldExtract($database, $field);\n if ($field === null) {\n return ExcelError::VALUE();\n }\n\n return MathTrig\\Operations::product(\n self::getFilteredColumn($database, $field, $criteria)\n );\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Database/DStDev.php",
"content": "|int|string $field Indicates which column is used in the function. Enter the\n * column label enclosed between double quotation marks, such as\n * \"Age\" or \"Yield,\" or a number (without quotation marks) that\n * represents the position of the column within the list: 1 for\n * the first column, 2 for the second column, and so on.\n * @param mixed[][] $criteria The range of cells that contains the conditions you specify.\n * You can use any range for the criteria argument, as long as it\n * includes at least one column label and at least one cell below\n * the column label in which you specify a condition for the\n * column.\n */\n public static function evaluate(array $database, array|null|int|string $field, array $criteria): float|string\n {\n $field = self::fieldExtract($database, $field);\n if ($field === null) {\n return ExcelError::VALUE();\n }\n\n return StandardDeviations::STDEV(\n self::getFilteredColumn($database, $field, $criteria)\n );\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Database/DStDevP.php",
"content": "|int|string $field Indicates which column is used in the function. Enter the\n * column label enclosed between double quotation marks, such as\n * \"Age\" or \"Yield,\" or a number (without quotation marks) that\n * represents the position of the column within the list: 1 for\n * the first column, 2 for the second column, and so on.\n * @param mixed[][] $criteria The range of cells that contains the conditions you specify.\n * You can use any range for the criteria argument, as long as it\n * includes at least one column label and at least one cell below\n * the column label in which you specify a condition for the\n * column.\n */\n public static function evaluate(array $database, array|null|int|string $field, array $criteria): float|string\n {\n $field = self::fieldExtract($database, $field);\n if ($field === null) {\n return ExcelError::VALUE();\n }\n\n return StandardDeviations::STDEVP(\n self::getFilteredColumn($database, $field, $criteria)\n );\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Database/DSum.php",
"content": "|int|string $field Indicates which column is used in the function. Enter the\n * column label enclosed between double quotation marks, such as\n * \"Age\" or \"Yield,\" or a number (without quotation marks) that\n * represents the position of the column within the list: 1 for\n * the first column, 2 for the second column, and so on.\n * @param mixed[][] $criteria The range of cells that contains the conditions you specify.\n * You can use any range for the criteria argument, as long as it\n * includes at least one column label and at least one cell below\n * the column label in which you specify a condition for the\n * column.\n */\n public static function evaluate(array $database, array|null|int|string $field, array $criteria, bool $returnNull = false): null|float|string\n {\n $field = self::fieldExtract($database, $field);\n if ($field === null) {\n return $returnNull ? null : ExcelError::VALUE();\n }\n\n return MathTrig\\Sum::sumIgnoringStrings(\n self::getFilteredColumn($database, $field, $criteria)\n );\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Database/DVar.php",
"content": "|int|string $field Indicates which column is used in the function. Enter the\n * column label enclosed between double quotation marks, such as\n * \"Age\" or \"Yield,\" or a number (without quotation marks) that\n * represents the position of the column within the list: 1 for\n * the first column, 2 for the second column, and so on.\n * @param mixed[][] $criteria The range of cells that contains the conditions you specify.\n * You can use any range for the criteria argument, as long as it\n * includes at least one column label and at least one cell below\n * the column label in which you specify a condition for the\n * column.\n *\n * @return float|string (string if result is an error)\n */\n public static function evaluate(array $database, array|null|int|string $field, array $criteria): string|float\n {\n $field = self::fieldExtract($database, $field);\n if ($field === null) {\n return ExcelError::VALUE();\n }\n\n return Variances::VAR(\n self::getFilteredColumn($database, $field, $criteria)\n );\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Database/DVarP.php",
"content": "|int|string $field Indicates which column is used in the function. Enter the\n * column label enclosed between double quotation marks, such as\n * \"Age\" or \"Yield,\" or a number (without quotation marks) that\n * represents the position of the column within the list: 1 for\n * the first column, 2 for the second column, and so on.\n * @param mixed[][] $criteria The range of cells that contains the conditions you specify.\n * You can use any range for the criteria argument, as long as it\n * includes at least one column label and at least one cell below\n * the column label in which you specify a condition for the\n * column.\n *\n * @return float|string (string if result is an error)\n */\n public static function evaluate(array $database, array|null|int|string $field, array $criteria): string|float\n {\n $field = self::fieldExtract($database, $field);\n if ($field === null) {\n return ExcelError::VALUE();\n }\n\n return Variances::VARP(\n self::getFilteredColumn($database, $field, $criteria)\n );\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Database/DatabaseAbstract.php",
"content": "|int|string $field Indicates which column is used in the function. Enter the\n * column label enclosed between double quotation marks, such as\n * \"Age\" or \"Yield,\" or a number (without quotation marks) that\n * represents the position of the column within the list: 1 for\n * the first column, 2 for the second column, and so on.\n * @param mixed[] $criteria The range of cells that contains the conditions you specify.\n * You can use any range for the criteria argument, as long as it\n * includes at least one column label and at least one cell below\n * the column label in which you specify a condition for the\n * column.\n */\n abstract public static function evaluate(array $database, array|null|int|string $field, array $criteria): null|float|int|string;\n\n /**\n * fieldExtract.\n *\n * Extracts the column ID to use for the data field.\n *\n * @param mixed[] $database The range of cells that makes up the list or database.\n * A database is a list of related data in which rows of related\n * information are records, and columns of data are fields. The\n * first row of the list contains labels for each column.\n * @param mixed $field Indicates which column is used in the function. Enter the\n * column label enclosed between double quotation marks, such as\n * \"Age\" or \"Yield,\" or a number (without quotation marks) that\n * represents the position of the column within the list: 1 for\n * the first column, 2 for the second column, and so on.\n */\n protected static function fieldExtract(array $database, mixed $field): ?int\n {\n /** @var ?string */\n $single = Functions::flattenSingleValue($field);\n $field = strtoupper($single ?? '');\n if ($field === '') {\n return null;\n }\n\n /** @var callable */\n $callable = 'strtoupper';\n $fieldNames = array_map($callable, array_shift($database)); //* @phpstan-ignore-line\n if (is_numeric($field)) {\n $field = (int) $field - 1;\n if ($field < 0 || $field >= count($fieldNames)) {\n return null;\n }\n\n return $field;\n }\n $key = array_search($field, array_values($fieldNames), true);\n\n return ($key !== false) ? (int) $key : null;\n }\n\n /**\n * filter.\n *\n * Parses the selection criteria, extracts the database rows that match those criteria, and\n * returns that subset of rows.\n *\n * @param mixed[] $database The range of cells that makes up the list or database.\n * A database is a list of related data in which rows of related\n * information are records, and columns of data are fields. The\n * first row of the list contains labels for each column.\n * @param mixed[][] $criteria The range of cells that contains the conditions you specify.\n * You can use any range for the criteria argument, as long as it\n * includes at least one column label and at least one cell below\n * the column label in which you specify a condition for the\n * column.\n *\n * @return mixed[]\n */\n protected static function filter(array $database, array $criteria): array\n {\n /** @var mixed[] */\n $fieldNames = array_shift($database);\n $criteriaNames = array_shift($criteria);\n\n // Convert the criteria into a set of AND/OR conditions with [:placeholders]\n /** @var string[] $criteriaNames */\n $query = self::buildQuery($criteriaNames, $criteria);\n\n // Loop through each row of the database\n /** @var mixed[][] $criteriaNames */\n return self::executeQuery($database, $query, $criteriaNames, $fieldNames);\n }\n\n /**\n * @param mixed[] $database The range of cells that makes up the list or database\n * @param mixed[][] $criteria\n *\n * @return mixed[]\n */\n protected static function getFilteredColumn(array $database, ?int $field, array $criteria): array\n {\n // reduce the database to a set of rows that match all the criteria\n $database = self::filter($database, $criteria);\n $defaultReturnColumnValue = ($field === null) ? 1 : null;\n\n // extract an array of values for the requested column\n $columnData = [];\n /** @var mixed[] $row */\n foreach ($database as $rowKey => $row) {\n $keys = array_keys($row);\n $key = ($field === null) ? null : ($keys[$field] ?? null);\n $columnKey = $key ?? 'A';\n $columnData[$rowKey][$columnKey] = ($key === null) ? $defaultReturnColumnValue : ($row[$key] ?? $defaultReturnColumnValue);\n }\n\n return $columnData;\n }\n\n /**\n * @param string[] $criteriaNames\n * @param mixed[][] $criteria\n */\n private static function buildQuery(array $criteriaNames, array $criteria): string\n {\n $baseQuery = [];\n foreach ($criteria as $key => $criterion) {\n foreach ($criterion as $field => $value) {\n $criterionName = $criteriaNames[$field];\n if ($value !== null) {\n $condition = self::buildCondition($value, $criterionName);\n $baseQuery[$key][] = $condition;\n }\n }\n }\n\n $rowQuery = array_map(\n fn ($rowValue): string => (count($rowValue) > 1) ? 'AND(' . implode(',', $rowValue) . ')' : ($rowValue[0] ?? ''), // @phpstan-ignore-line\n $baseQuery\n );\n\n return (count($rowQuery) > 1) ? 'OR(' . implode(',', $rowQuery) . ')' : ($rowQuery[0] ?? '');\n }\n\n private static function buildCondition(mixed $criterion, string $criterionName): string\n {\n $ifCondition = Functions::ifCondition($criterion);\n\n // Check for wildcard characters used in the condition\n $result = preg_match('/(?[^\"]*)(?\".*[*?].*\")/ui', $ifCondition, $matches);\n if ($result !== 1) {\n return \"[:{$criterionName}]{$ifCondition}\";\n }\n\n $trueFalse = ($matches['operator'] !== '<>');\n $wildcard = WildcardMatch::wildcard($matches['operand']);\n $condition = \"WILDCARDMATCH([:{$criterionName}],{$wildcard})\";\n if ($trueFalse === false) {\n $condition = \"NOT({$condition})\";\n }\n\n return $condition;\n }\n\n /**\n * @param mixed[] $database\n * @param mixed[][] $criteria\n * @param array $fields\n *\n * @return mixed[]\n */\n private static function executeQuery(array $database, string $query, array $criteria, array $fields): array\n {\n foreach ($database as $dataRow => $dataValues) {\n // Substitute actual values from the database row for our [:placeholders]\n $conditions = $query;\n foreach ($criteria as $criterion) {\n /** @var string $criterion */\n /** @var mixed[] $dataValues */\n $conditions = self::processCondition($criterion, $fields, $dataValues, $conditions);\n }\n\n // evaluate the criteria against the row data\n $result = Calculation::getInstance()->_calculateFormulaValue('=' . $conditions);\n\n // If the row failed to meet the criteria, remove it from the database\n if ($result !== true) {\n unset($database[$dataRow]);\n }\n }\n\n return $database;\n }\n\n /**\n * @param array $fields\n * @param array $dataValues\n */\n private static function processCondition(string $criterion, array $fields, array $dataValues, string $conditions): string\n {\n $key = array_search($criterion, $fields, true);\n\n $dataValue = 'NULL';\n if (is_bool($dataValues[$key])) {\n $dataValue = ($dataValues[$key]) ? 'TRUE' : 'FALSE';\n } elseif ($dataValues[$key] !== null) {\n $dataValue = $dataValues[$key];\n // escape quotes if we have a string containing quotes\n if (is_string($dataValue) && str_contains($dataValue, '\"')) {\n $dataValue = str_replace('\"', '\"\"', $dataValue);\n }\n if (is_string($dataValue)) {\n $dataValue = Calculation::wrapResult(strtoupper($dataValue));\n }\n $dataValue = StringHelper::convertToString($dataValue);\n }\n\n return str_replace('[:' . $criterion . ']', $dataValue, $conditions);\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/DateTimeExcel/Constants.php",
"content": " self::DOW_SUNDAY,\n self::DOW_MONDAY,\n self::STARTWEEK_MONDAY_ALT => self::DOW_MONDAY,\n self::DOW_TUESDAY,\n self::DOW_WEDNESDAY,\n self::DOW_THURSDAY,\n self::DOW_FRIDAY,\n self::DOW_SATURDAY,\n self::DOW_SUNDAY,\n self::STARTWEEK_MONDAY_ISO => self::STARTWEEK_MONDAY_ISO,\n ];\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/DateTimeExcel/Current.php",
"content": "format('c'));\n\n return Helpers::dateParseSucceeded($dateArray) ? Helpers::returnIn3FormatsArray($dateArray, true) : ExcelError::VALUE();\n }\n\n /**\n * DATETIMENOW.\n *\n * Returns the current date and time.\n * The NOW function is useful when you need to display the current date and time on a worksheet or\n * calculate a value based on the current date and time, and have that value updated each time you\n * open the worksheet.\n *\n * NOTE: When used in a Cell Formula, MS Excel changes the cell format so that it matches the date\n * and time format of your regional settings. PhpSpreadsheet does not change cell formatting in this way.\n *\n * Excel Function:\n * NOW()\n *\n * @return DateTime|float|int|string Excel date/time serial value, PHP date/time serial value or PHP date/time object,\n * depending on the value of the ReturnDateType flag\n */\n public static function now(): DateTime|float|int|string\n {\n $dti = new DateTimeImmutable();\n $dateArray = Helpers::dateParse($dti->format('c'));\n\n return Helpers::dateParseSucceeded($dateArray) ? Helpers::returnIn3FormatsArray($dateArray) : ExcelError::VALUE();\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/DateTimeExcel/Date.php",
"content": "|float|int|string $year The value of the year argument can include one to four digits.\n * Excel interprets the year argument according to the configured\n * date system: 1900 or 1904.\n * If year is between 0 (zero) and 1899 (inclusive), Excel adds that\n * value to 1900 to calculate the year. For example, DATE(108,1,2)\n * returns January 2, 2008 (1900+108).\n * If year is between 1900 and 9999 (inclusive), Excel uses that\n * value as the year. For example, DATE(2008,1,2) returns January 2,\n * 2008.\n * If year is less than 0 or is 10000 or greater, Excel returns the\n * #NUM! error value.\n * @param array|float|int|string $month A positive or negative integer representing the month of the year\n * from 1 to 12 (January to December).\n * If month is greater than 12, month adds that number of months to\n * the first month in the year specified. For example, DATE(2008,14,2)\n * returns the serial number representing February 2, 2009.\n * If month is less than 1, month subtracts the magnitude of that\n * number of months, plus 1, from the first month in the year\n * specified. For example, DATE(2008,-3,2) returns the serial number\n * representing September 2, 2007.\n * @param array|float|int|string $day A positive or negative integer representing the day of the month\n * from 1 to 31.\n * If day is greater than the number of days in the month specified,\n * day adds that number of days to the first day in the month. For\n * example, DATE(2008,1,35) returns the serial number representing\n * February 4, 2008.\n * If day is less than 1, day subtracts the magnitude that number of\n * days, plus one, from the first day of the month specified. For\n * example, DATE(2008,1,-15) returns the serial number representing\n * December 16, 2007.\n *\n * @return array|DateTime|float|int|string Excel date/time serial value, PHP date/time serial value or PHP date/time object,\n * depending on the value of the ReturnDateType flag\n * If an array of numbers is passed as the argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function fromYMD(array|float|int|string $year, null|array|bool|float|int|string $month, array|float|int|string $day): float|int|DateTime|string|array\n {\n if (is_array($year) || is_array($month) || is_array($day)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $year, $month, $day);\n }\n\n $baseYear = SharedDateHelper::getExcelCalendar();\n\n try {\n $year = self::getYear($year, $baseYear);\n $month = self::getMonth($month);\n $day = self::getDay($day);\n self::adjustYearMonth($year, $month, $baseYear);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n // Execute function\n $excelDateValue = SharedDateHelper::formattedPHPToExcel($year, $month, $day);\n\n return Helpers::returnIn3FormatsFloat($excelDateValue);\n }\n\n /**\n * Convert year from multiple formats to int.\n */\n private static function getYear(mixed $year, int $baseYear): int\n {\n if ($year === null) {\n $year = 0;\n } elseif (is_scalar($year)) {\n $year = StringHelper::testStringAsNumeric((string) $year);\n }\n if (!is_numeric($year)) {\n throw new Exception(ExcelError::VALUE());\n }\n $year = (int) $year;\n\n if ($year < ($baseYear - 1900)) {\n throw new Exception(ExcelError::NAN());\n }\n if ((($baseYear - 1900) !== 0) && ($year < $baseYear) && ($year >= 1900)) {\n throw new Exception(ExcelError::NAN());\n }\n\n if (($year < $baseYear) && ($year >= ($baseYear - 1900))) {\n $year += 1900;\n }\n\n return (int) $year;\n }\n\n /**\n * Convert month from multiple formats to int.\n */\n private static function getMonth(mixed $month): int\n {\n if (is_string($month)) {\n if (!is_numeric($month)) {\n $month = SharedDateHelper::monthStringToNumber($month);\n }\n } elseif ($month === null) {\n $month = 0;\n } elseif (is_bool($month)) {\n $month = (int) $month;\n }\n if (!is_numeric($month)) {\n throw new Exception(ExcelError::VALUE());\n }\n\n return (int) $month;\n }\n\n /**\n * Convert day from multiple formats to int.\n */\n private static function getDay(mixed $day): int\n {\n if (is_string($day) && !is_numeric($day)) {\n $day = SharedDateHelper::dayStringToNumber($day);\n }\n\n if ($day === null) {\n $day = 0;\n } elseif (is_scalar($day)) {\n $day = StringHelper::testStringAsNumeric((string) $day);\n }\n if (!is_numeric($day)) {\n throw new Exception(ExcelError::VALUE());\n }\n\n return (int) $day;\n }\n\n private static function adjustYearMonth(int &$year, int &$month, int $baseYear): void\n {\n if ($month < 1) {\n // Handle year/month adjustment if month < 1\n --$month;\n $year += (int) (ceil($month / 12) - 1);\n $month = 13 - abs($month % 12);\n } elseif ($month > 12) {\n // Handle year/month adjustment if month > 12\n $year += intdiv($month, 12);\n $month = ($month % 12);\n }\n\n // Re-validate the year parameter after adjustments\n if (($year < $baseYear) || ($year >= 10000)) {\n throw new Exception(ExcelError::NAN());\n }\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/DateTimeExcel/DateParts.php",
"content": "|int|string Day of the month\n * If an array of numbers is passed as the argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function day(mixed $dateValue): array|int|string\n {\n if (is_array($dateValue)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $dateValue);\n }\n\n $weirdResult = self::weirdCondition($dateValue);\n if ($weirdResult >= 0) {\n return $weirdResult;\n }\n\n try {\n $dateValue = Helpers::getDateValue($dateValue);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n // Execute function\n $PHPDateObject = SharedDateHelper::excelToDateTimeObject($dateValue);\n SharedDateHelper::roundMicroseconds($PHPDateObject);\n\n return (int) $PHPDateObject->format('j');\n }\n\n /**\n * MONTHOFYEAR.\n *\n * Returns the month of a date represented by a serial number.\n * The month is given as an integer, ranging from 1 (January) to 12 (December).\n *\n * Excel Function:\n * MONTH(dateValue)\n *\n * @param mixed $dateValue Excel date serial value (float), PHP date timestamp (integer),\n * PHP DateTime object, or a standard date string\n * Or can be an array of date values\n *\n * @return array|int|string Month of the year\n * If an array of numbers is passed as the argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function month(mixed $dateValue): array|string|int\n {\n if (is_array($dateValue)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $dateValue);\n }\n\n try {\n $dateValue = Helpers::getDateValue($dateValue);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n if ($dateValue < 1 && SharedDateHelper::getExcelCalendar() === SharedDateHelper::CALENDAR_WINDOWS_1900) {\n return 1;\n }\n\n // Execute function\n $PHPDateObject = SharedDateHelper::excelToDateTimeObject($dateValue);\n SharedDateHelper::roundMicroseconds($PHPDateObject);\n\n return (int) $PHPDateObject->format('n');\n }\n\n /**\n * YEAR.\n *\n * Returns the year corresponding to a date.\n * The year is returned as an integer in the range 1900-9999.\n *\n * Excel Function:\n * YEAR(dateValue)\n *\n * @param mixed $dateValue Excel date serial value (float), PHP date timestamp (integer),\n * PHP DateTime object, or a standard date string\n * Or can be an array of date values\n *\n * @return array|int|string Year\n * If an array of numbers is passed as the argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function year(mixed $dateValue): array|string|int\n {\n if (is_array($dateValue)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $dateValue);\n }\n\n try {\n $dateValue = Helpers::getDateValue($dateValue);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n if ($dateValue < 1 && SharedDateHelper::getExcelCalendar() === SharedDateHelper::CALENDAR_WINDOWS_1900) {\n return 1900;\n }\n // Execute function\n $PHPDateObject = SharedDateHelper::excelToDateTimeObject($dateValue);\n SharedDateHelper::roundMicroseconds($PHPDateObject);\n\n return (int) $PHPDateObject->format('Y');\n }\n\n /**\n * @param mixed $dateValue Excel date serial value (float), PHP date timestamp (integer),\n * PHP DateTime object, or a standard date string\n */\n private static function weirdCondition(mixed $dateValue): int\n {\n // Excel does not treat 0 consistently for DAY vs. (MONTH or YEAR)\n if (SharedDateHelper::getExcelCalendar() === SharedDateHelper::CALENDAR_WINDOWS_1900 && Functions::getCompatibilityMode() == Functions::COMPATIBILITY_EXCEL) {\n if (is_bool($dateValue)) {\n return (int) $dateValue;\n }\n if ($dateValue === null) {\n return 0;\n }\n if (is_numeric($dateValue) && $dateValue < 1 && $dateValue >= 0) {\n return 0;\n }\n }\n\n return -1;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/DateTimeExcel/DateValue.php",
"content": "|bool|float|int|string $dateValue Text that represents a date in a Microsoft Excel date format.\n * For example, \"1/30/2008\" or \"30-Jan-2008\" are text strings within\n * quotation marks that represent dates. Using the default date\n * system in Excel for Windows, date_text must represent a date from\n * January 1, 1900, to December 31, 9999. Using the default date\n * system in Excel for the Macintosh, date_text must represent a date\n * from January 1, 1904, to December 31, 9999. DATEVALUE returns the\n * #VALUE! error value if date_text is out of this range.\n * Or can be an array of date values\n *\n * @return array|DateTime|float|int|string Excel date/time serial value, PHP date/time serial value or PHP date/time object,\n * depending on the value of the ReturnDateType flag\n * If an array of numbers is passed as the argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function fromString(null|array|string|int|bool|float $dateValue): array|string|float|int|DateTime\n {\n if (is_array($dateValue)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $dateValue);\n }\n\n // try to parse as date iff there is at least one digit\n if (is_string($dateValue) && preg_match('/\\d/', $dateValue) !== 1) {\n return ExcelError::VALUE();\n }\n\n $dti = new DateTimeImmutable();\n $baseYear = SharedDateHelper::getExcelCalendar();\n $dateValue = trim((string) $dateValue, '\"');\n // Strip any ordinals because they're allowed in Excel (English only)\n $dateValue = (string) preg_replace('/(\\d)(st|nd|rd|th)([ -\\/])/Ui', '$1$3', $dateValue);\n // Convert separators (/ . or space) to hyphens (should also handle dot used for ordinals in some countries, e.g. Denmark, Germany)\n $dateValue = str_replace(['/', '.', '-', ' '], ' ', $dateValue);\n\n $yearFound = false;\n $t1 = explode(' ', $dateValue);\n $t = '';\n foreach ($t1 as &$t) {\n if ((is_numeric($t)) && ($t > 31)) {\n if ($yearFound) {\n return ExcelError::VALUE();\n }\n if ($t < 100) {\n $t += 1900;\n }\n $yearFound = true;\n }\n }\n if (count($t1) === 1) {\n // We've been fed a time value without any date\n return ((!str_contains((string) $t, ':'))) ? ExcelError::Value() : 0.0;\n }\n unset($t);\n\n $dateValue = self::t1ToString($t1, $dti, $yearFound);\n\n $PHPDateArray = self::setUpArray($dateValue, $dti);\n\n return self::finalResults($PHPDateArray, $dti, $baseYear);\n }\n\n /** @param mixed[] $t1 */\n private static function t1ToString(array $t1, DateTimeImmutable $dti, bool $yearFound): string\n {\n if (count($t1) == 2) {\n // We only have two parts of the date: either day/month or month/year\n if ($yearFound) {\n array_unshift($t1, 1);\n } else {\n if (is_numeric($t1[1]) && $t1[1] > 29) {\n $t1[1] += 1900;\n array_unshift($t1, 1);\n } else {\n $t1[] = $dti->format('Y');\n }\n }\n }\n $dateValue = implode(' ', $t1);\n\n return $dateValue;\n }\n\n /**\n * Parse date.\n *\n * @return mixed[]\n */\n private static function setUpArray(string $dateValue, DateTimeImmutable $dti): array\n {\n $PHPDateArray = Helpers::dateParse($dateValue);\n if (!Helpers::dateParseSucceeded($PHPDateArray)) {\n // If original count was 1, we've already returned.\n // If it was 2, we added another.\n // Therefore, neither of the first 2 strtoks below can fail.\n $testVal1 = strtok($dateValue, '- ');\n $testVal2 = strtok('- ');\n $testVal3 = strtok('- ') ?: $dti->format('Y');\n Helpers::adjustYear((string) $testVal1, (string) $testVal2, $testVal3);\n $PHPDateArray = Helpers::dateParse($testVal1 . '-' . $testVal2 . '-' . $testVal3);\n if (!Helpers::dateParseSucceeded($PHPDateArray)) {\n $PHPDateArray = Helpers::dateParse($testVal2 . '-' . $testVal1 . '-' . $testVal3);\n }\n }\n\n return $PHPDateArray;\n }\n\n /**\n * Final results.\n *\n * @param mixed[] $PHPDateArray\n *\n * @return DateTime|float|int|string Excel date/time serial value, PHP date/time serial value or PHP date/time object,\n * depending on the value of the ReturnDateType flag\n */\n private static function finalResults(array $PHPDateArray, DateTimeImmutable $dti, int $baseYear): string|float|int|DateTime\n {\n $retValue = ExcelError::Value();\n if (Helpers::dateParseSucceeded($PHPDateArray)) {\n /** @var array{year: int, month: int, day: int, hour: int, minute: int, second: int} $PHPDateArray */\n // Execute function\n Helpers::replaceIfEmpty($PHPDateArray['year'], $dti->format('Y'));\n if ($PHPDateArray['year'] < $baseYear) {\n return ExcelError::VALUE();\n }\n Helpers::replaceIfEmpty($PHPDateArray['month'], $dti->format('m'));\n Helpers::replaceIfEmpty($PHPDateArray['day'], $dti->format('d'));\n /** @var array{year: int, month: int, day: int, hour: int, minute: int, second: int} $PHPDateArray */\n $PHPDateArray['hour'] = 0;\n $PHPDateArray['minute'] = 0;\n $PHPDateArray['second'] = 0;\n $month = self::getInt($PHPDateArray, 'month');\n $day = self::getInt($PHPDateArray, 'day');\n $year = self::getInt($PHPDateArray, 'year');\n if (!checkdate($month, $day, $year)) {\n return ($year === 1900 && $month === 2 && $day === 29) ? Helpers::returnIn3FormatsFloat(60.0) : ExcelError::VALUE();\n }\n $retValue = Helpers::returnIn3FormatsArray($PHPDateArray, true);\n }\n\n return $retValue;\n }\n\n /** @param mixed[] $array */\n private static function getInt(array $array, string $index): int\n {\n return (array_key_exists($index, $array) && is_numeric($array[$index])) ? (int) $array[$index] : 0;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/DateTimeExcel/Days.php",
"content": "|DateTimeInterface|float|int|string $endDate Excel date serial value (float),\n * PHP date timestamp (integer), PHP DateTime object, or a standard date string\n * Or can be an array of date values\n * @param array|DateTimeInterface|float|int|string $startDate Excel date serial value (float),\n * PHP date timestamp (integer), PHP DateTime object, or a standard date string\n * Or can be an array of date values\n *\n * @return array|int|string Number of days between start date and end date or an error\n * If an array of values is passed for the $startDate or $endDays,arguments, then the returned result\n * will also be an array with matching dimensions\n */\n public static function between(array|DateTimeInterface|float|int|string $endDate, array|DateTimeInterface|float|int|string $startDate): array|int|string\n {\n if (is_array($endDate) || is_array($startDate)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $endDate, $startDate);\n }\n\n try {\n $startDate = Helpers::getDateValue($startDate);\n $endDate = Helpers::getDateValue($endDate);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n // Execute function\n $PHPStartDateObject = SharedDateHelper::excelToDateTimeObject($startDate);\n $PHPEndDateObject = SharedDateHelper::excelToDateTimeObject($endDate);\n\n $days = ExcelError::VALUE();\n $diff = $PHPStartDateObject->diff($PHPEndDateObject);\n if (!is_bool($diff->days)) {\n $days = $diff->days;\n if ($diff->invert) {\n $days = -$days;\n }\n }\n\n return $days;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/DateTimeExcel/Days360.php",
"content": "|int|string Number of days between start date and end date\n * If an array of values is passed for the $startDate or $endDays,arguments, then the returned result\n * will also be an array with matching dimensions\n */\n public static function between(mixed $startDate = 0, mixed $endDate = 0, mixed $method = false): array|string|int\n {\n if (is_array($startDate) || is_array($endDate) || is_array($method)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $startDate, $endDate, $method);\n }\n\n try {\n $startDate = Helpers::getDateValue($startDate);\n $endDate = Helpers::getDateValue($endDate);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n if (!is_bool($method)) {\n return ExcelError::VALUE();\n }\n\n // Execute function\n $PHPStartDateObject = SharedDateHelper::excelToDateTimeObject($startDate);\n $startDay = $PHPStartDateObject->format('j');\n $startMonth = $PHPStartDateObject->format('n');\n $startYear = $PHPStartDateObject->format('Y');\n\n $PHPEndDateObject = SharedDateHelper::excelToDateTimeObject($endDate);\n $endDay = $PHPEndDateObject->format('j');\n $endMonth = $PHPEndDateObject->format('n');\n $endYear = $PHPEndDateObject->format('Y');\n\n return self::dateDiff360((int) $startDay, (int) $startMonth, (int) $startYear, (int) $endDay, (int) $endMonth, (int) $endYear, !$method);\n }\n\n /**\n * Return the number of days between two dates based on a 360-day calendar.\n */\n private static function dateDiff360(int $startDay, int $startMonth, int $startYear, int $endDay, int $endMonth, int $endYear, bool $methodUS): int\n {\n $startDay = self::getStartDay($startDay, $startMonth, $startYear, $methodUS);\n $endDay = self::getEndDay($endDay, $endMonth, $endYear, $startDay, $methodUS);\n\n return $endDay + $endMonth * 30 + $endYear * 360 - $startDay - $startMonth * 30 - $startYear * 360;\n }\n\n private static function getStartDay(int $startDay, int $startMonth, int $startYear, bool $methodUS): int\n {\n if ($startDay == 31) {\n --$startDay;\n } elseif ($methodUS && ($startMonth == 2 && ($startDay == 29 || ($startDay == 28 && !Helpers::isLeapYear($startYear))))) {\n $startDay = 30;\n }\n\n return $startDay;\n }\n\n private static function getEndDay(int $endDay, int &$endMonth, int &$endYear, int $startDay, bool $methodUS): int\n {\n if ($endDay == 31) {\n if ($methodUS && $startDay != 30) {\n $endDay = 1;\n if ($endMonth == 12) {\n ++$endYear;\n $endMonth = 1;\n } else {\n ++$endMonth;\n }\n } else {\n $endDay = 30;\n }\n }\n\n return $endDay;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/DateTimeExcel/Difference.php",
"content": "|string $unit Or can be an array of unit values\n *\n * @return array|int|string Interval between the dates\n * If an array of values is passed for the $startDate or $endDays,arguments, then the returned result\n * will also be an array with matching dimensions\n */\n public static function interval(mixed $startDate, mixed $endDate, array|string $unit = 'D')\n {\n if (is_array($startDate) || is_array($endDate) || is_array($unit)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $startDate, $endDate, $unit);\n }\n\n try {\n $startDate = Helpers::getDateValue($startDate);\n $endDate = Helpers::getDateValue($endDate);\n $difference = self::initialDiff($startDate, $endDate);\n $unit = strtoupper($unit);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n // Execute function\n $PHPStartDateObject = SharedDateHelper::excelToDateTimeObject($startDate);\n $startDays = (int) $PHPStartDateObject->format('j');\n //$startMonths = (int) $PHPStartDateObject->format('n');\n $startYears = (int) $PHPStartDateObject->format('Y');\n\n $PHPEndDateObject = SharedDateHelper::excelToDateTimeObject($endDate);\n $endDays = (int) $PHPEndDateObject->format('j');\n //$endMonths = (int) $PHPEndDateObject->format('n');\n $endYears = (int) $PHPEndDateObject->format('Y');\n\n $PHPDiffDateObject = $PHPEndDateObject->diff($PHPStartDateObject);\n\n $retVal = false;\n $retVal = self::replaceRetValue($retVal, $unit, 'D') ?? self::datedifD($difference);\n $retVal = self::replaceRetValue($retVal, $unit, 'M') ?? self::datedifM($PHPDiffDateObject);\n $retVal = self::replaceRetValue($retVal, $unit, 'MD') ?? self::datedifMD($startDays, $endDays, $PHPEndDateObject, $PHPDiffDateObject);\n $retVal = self::replaceRetValue($retVal, $unit, 'Y') ?? self::datedifY($PHPDiffDateObject);\n $retVal = self::replaceRetValue($retVal, $unit, 'YD') ?? self::datedifYD($difference, $startYears, $endYears, $PHPStartDateObject, $PHPEndDateObject);\n $retVal = self::replaceRetValue($retVal, $unit, 'YM') ?? self::datedifYM($PHPDiffDateObject);\n\n return is_bool($retVal) ? ExcelError::VALUE() : $retVal;\n }\n\n private static function initialDiff(float $startDate, float $endDate): float\n {\n // Validate parameters\n if ($startDate > $endDate) {\n throw new Exception(ExcelError::NAN());\n }\n\n return $endDate - $startDate;\n }\n\n /**\n * Decide whether it's time to set retVal.\n */\n private static function replaceRetValue(bool|int $retVal, string $unit, string $compare): null|bool|int\n {\n if ($retVal !== false || $unit !== $compare) {\n return $retVal;\n }\n\n return null;\n }\n\n private static function datedifD(float $difference): int\n {\n return (int) $difference;\n }\n\n private static function datedifM(DateInterval $PHPDiffDateObject): int\n {\n return 12 * (int) $PHPDiffDateObject->format('%y') + (int) $PHPDiffDateObject->format('%m');\n }\n\n private static function datedifMD(int $startDays, int $endDays, DateTime $PHPEndDateObject, DateInterval $PHPDiffDateObject): int\n {\n if ($endDays < $startDays) {\n $retVal = $endDays;\n $PHPEndDateObject->modify('-' . $endDays . ' days');\n $adjustDays = (int) $PHPEndDateObject->format('j');\n $retVal += ($adjustDays - $startDays);\n } else {\n $retVal = (int) $PHPDiffDateObject->format('%d');\n }\n\n return $retVal;\n }\n\n private static function datedifY(DateInterval $PHPDiffDateObject): int\n {\n return (int) $PHPDiffDateObject->format('%y');\n }\n\n private static function datedifYD(float $difference, int $startYears, int $endYears, DateTime $PHPStartDateObject, DateTime $PHPEndDateObject): int\n {\n $retVal = (int) $difference;\n if ($endYears > $startYears) {\n $isLeapStartYear = $PHPStartDateObject->format('L');\n $wasLeapEndYear = $PHPEndDateObject->format('L');\n\n // Adjust end year to be as close as possible as start year\n while ($PHPEndDateObject >= $PHPStartDateObject) {\n $PHPEndDateObject->modify('-1 year');\n //$endYears = $PHPEndDateObject->format('Y');\n }\n $PHPEndDateObject->modify('+1 year');\n\n // Get the result\n $retVal = (int) $PHPEndDateObject->diff($PHPStartDateObject)->days;\n\n // Adjust for leap years cases\n $isLeapEndYear = $PHPEndDateObject->format('L');\n $limit = new DateTime($PHPEndDateObject->format('Y-02-29'));\n if (!$isLeapStartYear && !$wasLeapEndYear && $isLeapEndYear && $PHPEndDateObject >= $limit) {\n --$retVal;\n }\n }\n\n return (int) $retVal;\n }\n\n private static function datedifYM(DateInterval $PHPDiffDateObject): int\n {\n return (int) $PHPDiffDateObject->format('%m');\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/DateTimeExcel/Helpers.php",
"content": "format('m');\n $oYear = (int) $PHPDateObject->format('Y');\n\n $adjustmentMonthsString = (string) $adjustmentMonths;\n if ($adjustmentMonths > 0) {\n $adjustmentMonthsString = '+' . $adjustmentMonths;\n }\n if ($adjustmentMonths != 0) {\n $PHPDateObject->modify($adjustmentMonthsString . ' months');\n }\n $nMonth = (int) $PHPDateObject->format('m');\n $nYear = (int) $PHPDateObject->format('Y');\n\n $monthDiff = ($nMonth - $oMonth) + (($nYear - $oYear) * 12);\n if ($monthDiff != $adjustmentMonths) {\n $adjustDays = (int) $PHPDateObject->format('d');\n $adjustDaysString = '-' . $adjustDays . ' days';\n $PHPDateObject->modify($adjustDaysString);\n }\n\n return $PHPDateObject;\n }\n\n /**\n * Help reduce perceived complexity of some tests.\n */\n public static function replaceIfEmpty(mixed &$value, mixed $altValue): void\n {\n $value = $value ?: $altValue;\n }\n\n /**\n * Adjust year in ambiguous situations.\n */\n public static function adjustYear(string $testVal1, string $testVal2, string &$testVal3): void\n {\n if (!is_numeric($testVal1) || $testVal1 < 31) {\n if (!is_numeric($testVal2) || $testVal2 < 12) {\n if (is_numeric($testVal3) && $testVal3 < 12) {\n $testVal3 = (string) ($testVal3 + 2000);\n }\n }\n }\n }\n\n /**\n * Return result in one of three formats.\n *\n * @param array{year: int, month: int, day: int, hour: int, minute: int, second: int} $dateArray\n */\n public static function returnIn3FormatsArray(array $dateArray, bool $noFrac = false): DateTime|float|int\n {\n $retType = Functions::getReturnDateType();\n if ($retType === Functions::RETURNDATE_PHP_DATETIME_OBJECT) {\n return new DateTime(\n $dateArray['year']\n . '-' . $dateArray['month']\n . '-' . $dateArray['day']\n . ' ' . $dateArray['hour']\n . ':' . $dateArray['minute']\n . ':' . $dateArray['second']\n );\n }\n $excelDateValue\n = SharedDateHelper::formattedPHPToExcel(\n $dateArray['year'],\n $dateArray['month'],\n $dateArray['day'],\n $dateArray['hour'],\n $dateArray['minute'],\n $dateArray['second']\n );\n if ($retType === Functions::RETURNDATE_EXCEL) {\n return $noFrac ? floor($excelDateValue) : $excelDateValue;\n }\n // RETURNDATE_UNIX_TIMESTAMP)\n\n return SharedDateHelper::excelToTimestamp($excelDateValue);\n }\n\n /**\n * Return result in one of three formats.\n */\n public static function returnIn3FormatsFloat(float $excelDateValue): float|int|DateTime\n {\n $retType = Functions::getReturnDateType();\n if ($retType === Functions::RETURNDATE_EXCEL) {\n return $excelDateValue;\n }\n if ($retType === Functions::RETURNDATE_UNIX_TIMESTAMP) {\n return SharedDateHelper::excelToTimestamp($excelDateValue);\n }\n // RETURNDATE_PHP_DATETIME_OBJECT\n\n return SharedDateHelper::excelToDateTimeObject($excelDateValue);\n }\n\n /**\n * Return result in one of three formats.\n */\n public static function returnIn3FormatsObject(DateTime $PHPDateObject): DateTime|float|int\n {\n $retType = Functions::getReturnDateType();\n if ($retType === Functions::RETURNDATE_PHP_DATETIME_OBJECT) {\n return $PHPDateObject;\n }\n if ($retType === Functions::RETURNDATE_EXCEL) {\n return (float) SharedDateHelper::PHPToExcel($PHPDateObject);\n }\n // RETURNDATE_UNIX_TIMESTAMP\n $stamp = SharedDateHelper::PHPToExcel($PHPDateObject);\n $stamp = is_bool($stamp) ? ((int) $stamp) : $stamp;\n\n return SharedDateHelper::excelToTimestamp($stamp);\n }\n\n private static function baseDate(): int\n {\n if (Functions::getCompatibilityMode() === Functions::COMPATIBILITY_OPENOFFICE) {\n return 0;\n }\n if (SharedDateHelper::getExcelCalendar() === SharedDateHelper::CALENDAR_MAC_1904) {\n return 0;\n }\n\n return 1;\n }\n\n /**\n * Many functions accept null/false/true argument treated as 0/0/1.\n */\n public static function nullFalseTrueToNumber(mixed &$number, bool $allowBool = true): void\n {\n $number = Functions::flattenSingleValue($number);\n $nullVal = self::baseDate();\n if ($number === null) {\n $number = $nullVal;\n } elseif ($allowBool && is_bool($number)) {\n $number = $nullVal + (int) $number;\n }\n }\n\n /**\n * Many functions accept null argument treated as 0.\n */\n public static function validateNumericNull(mixed $number): int|float\n {\n $number = Functions::flattenSingleValue($number);\n if ($number === null) {\n return 0;\n }\n if (is_int($number)) {\n return $number;\n }\n if (is_numeric($number)) {\n return (float) $number;\n }\n\n throw new Exception(ExcelError::VALUE());\n }\n\n /**\n * Many functions accept null/false/true argument treated as 0/0/1.\n *\n * @phpstan-assert float $number\n */\n public static function validateNotNegative(mixed $number): float\n {\n if (!is_numeric($number)) {\n throw new Exception(ExcelError::VALUE());\n }\n if ($number >= 0) {\n return (float) $number;\n }\n\n throw new Exception(ExcelError::NAN());\n }\n\n public static function silly1900(DateTime $PHPDateObject, string $mod = '-1 day'): void\n {\n $isoDate = $PHPDateObject->format('c');\n if ($isoDate < '1900-03-01') {\n $PHPDateObject->modify($mod);\n }\n }\n\n /** @return array{year: int, month: int, day: int, hour: int, minute: int, second: int} */\n public static function dateParse(string $string): array\n {\n /** @var array{year: int, month: int, day: int, hour: int, minute: int, second: int} */\n $temp = self::forceArray(date_parse($string));\n\n return $temp;\n }\n\n /** @param mixed[] $dateArray */\n public static function dateParseSucceeded(array $dateArray): bool\n {\n return $dateArray['error_count'] === 0;\n }\n\n /**\n * Despite documentation, date_parse probably never returns false.\n * Just in case, this routine helps guarantee it.\n *\n * @param array|false $dateArray\n *\n * @return mixed[]\n */\n private static function forceArray(array|bool $dateArray): array\n {\n return is_array($dateArray) ? $dateArray : ['error_count' => 1];\n }\n\n public static function floatOrInt(mixed $value): float|int\n {\n $result = Functions::scalar($value);\n\n return is_numeric($result) ? ($result + 0) : 0;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/DateTimeExcel/Month.php",
"content": "|int $adjustmentMonths The number of months before or after start_date.\n * A positive value for months yields a future date;\n * a negative value yields a past date.\n * Or can be an array of adjustment values\n *\n * @return array|DateTime|float|int|string Excel date/time serial value, PHP date/time serial value or PHP date/time object,\n * depending on the value of the ReturnDateType flag\n * If an array of values is passed as the argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function adjust(mixed $dateValue, array|string|bool|float|int $adjustmentMonths): DateTime|float|int|string|array\n {\n if (is_array($dateValue) || is_array($adjustmentMonths)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $dateValue, $adjustmentMonths);\n }\n\n try {\n $dateValue = Helpers::getDateValue($dateValue, false);\n $adjustmentMonths = Helpers::validateNumericNull($adjustmentMonths);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n $dateValue = floor($dateValue);\n $adjustmentMonths = floor($adjustmentMonths);\n\n // Execute function\n $PHPDateObject = Helpers::adjustDateByMonths($dateValue, $adjustmentMonths);\n\n return Helpers::returnIn3FormatsObject($PHPDateObject);\n }\n\n /**\n * EOMONTH.\n *\n * Returns the date value for the last day of the month that is the indicated number of months\n * before or after start_date.\n * Use EOMONTH to calculate maturity dates or due dates that fall on the last day of the month.\n *\n * Excel Function:\n * EOMONTH(dateValue,adjustmentMonths)\n *\n * @param mixed $dateValue Excel date serial value (float), PHP date timestamp (integer),\n * PHP DateTime object, or a standard date string\n * Or can be an array of date values\n * @param array|int $adjustmentMonths The number of months before or after start_date.\n * A positive value for months yields a future date;\n * a negative value yields a past date.\n * Or can be an array of adjustment values\n *\n * @return array|DateTime|float|int|string Excel date/time serial value, PHP date/time serial value or PHP date/time object,\n * depending on the value of the ReturnDateType flag\n * If an array of values is passed as the argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function lastDay(mixed $dateValue, array|float|int|bool|string $adjustmentMonths): array|string|DateTime|float|int\n {\n if (is_array($dateValue) || is_array($adjustmentMonths)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $dateValue, $adjustmentMonths);\n }\n\n try {\n $dateValue = Helpers::getDateValue($dateValue, false);\n $adjustmentMonths = Helpers::validateNumericNull($adjustmentMonths);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n $dateValue = floor($dateValue);\n $adjustmentMonths = floor($adjustmentMonths);\n\n // Execute function\n $PHPDateObject = Helpers::adjustDateByMonths($dateValue, $adjustmentMonths + 1);\n $adjustDays = (int) $PHPDateObject->format('d');\n $adjustDaysString = '-' . $adjustDays . ' days';\n $PHPDateObject->modify($adjustDaysString);\n\n return Helpers::returnIn3FormatsObject($PHPDateObject);\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/DateTimeExcel/NetworkDays.php",
"content": "|int|string Interval between the dates\n * If an array of values is passed for the $startDate or $endDate arguments, then the returned result\n * will also be an array with matching dimensions\n */\n public static function count(mixed $startDate, mixed $endDate, mixed ...$dateArgs): array|string|int\n {\n if (is_array($startDate) || is_array($endDate)) {\n return self::evaluateArrayArgumentsSubset(\n [self::class, __FUNCTION__],\n 2,\n $startDate,\n $endDate,\n ...$dateArgs\n );\n }\n\n try {\n // Retrieve the mandatory start and end date that are referenced in the function definition\n $sDate = Helpers::getDateValue($startDate);\n $eDate = Helpers::getDateValue($endDate);\n $startDate = min($sDate, $eDate);\n $endDate = max($sDate, $eDate);\n // Get the optional days\n $dateArgs = Functions::flattenArray($dateArgs);\n // Test any extra holiday parameters\n $holidayArray = [];\n foreach ($dateArgs as $holidayDate) {\n $holidayArray[] = Helpers::getDateValue($holidayDate);\n }\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n // Execute function\n $startDow = self::calcStartDow($startDate);\n $endDow = self::calcEndDow($endDate);\n $wholeWeekDays = (int) floor(($endDate - $startDate) / 7) * 5;\n $partWeekDays = self::calcPartWeekDays($startDow, $endDow);\n\n // Test any extra holiday parameters\n $holidayCountedArray = [];\n foreach ($holidayArray as $holidayDate) {\n if (($holidayDate >= $startDate) && ($holidayDate <= $endDate)) {\n if ((Week::day($holidayDate, 2) < 6) && (!in_array($holidayDate, $holidayCountedArray))) {\n --$partWeekDays;\n $holidayCountedArray[] = $holidayDate;\n }\n }\n }\n\n return self::applySign($wholeWeekDays + $partWeekDays, $sDate, $eDate);\n }\n\n private static function calcStartDow(float $startDate): int\n {\n $startDow = 6 - (int) Week::day($startDate, 2);\n if ($startDow < 0) {\n $startDow = 5;\n }\n\n return $startDow;\n }\n\n private static function calcEndDow(float $endDate): int\n {\n $endDow = (int) Week::day($endDate, 2);\n if ($endDow >= 6) {\n $endDow = 0;\n }\n\n return $endDow;\n }\n\n private static function calcPartWeekDays(int $startDow, int $endDow): int\n {\n $partWeekDays = $endDow + $startDow;\n if ($partWeekDays > 5) {\n $partWeekDays -= 5;\n }\n\n return $partWeekDays;\n }\n\n private static function applySign(int $result, float $sDate, float $eDate): int\n {\n return ($sDate > $eDate) ? -$result : $result;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/DateTimeExcel/Time.php",
"content": "|bool|float|int|string $hour A number from 0 (zero) to 32767 representing the hour.\n * Any value greater than 23 will be divided by 24 and the remainder\n * will be treated as the hour value. For example, TIME(27,0,0) =\n * TIME(3,0,0) = .125 or 3:00 AM.\n * @param null|array|bool|float|int|string $minute A number from 0 to 32767 representing the minute.\n * Any value greater than 59 will be converted to hours and minutes.\n * For example, TIME(0,750,0) = TIME(12,30,0) = .520833 or 12:30 PM.\n * @param null|array|bool|float|int|string $second A number from 0 to 32767 representing the second.\n * Any value greater than 59 will be converted to hours, minutes,\n * and seconds. For example, TIME(0,0,2000) = TIME(0,33,22) = .023148\n * or 12:33:20 AM\n * If an array of numbers is passed as the argument, then the returned result will also be an array\n * with the same dimensions\n *\n * @return array|DateTime|float|int|string Excel date/time serial value, PHP date/time serial value or PHP date/time object,\n * depending on the value of the ReturnDateType flag\n * If an array of numbers is passed as the argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function fromHMS(array|int|float|bool|null|string $hour, array|int|float|bool|null|string $minute, array|int|float|bool|null|string $second): array|string|float|int|DateTime\n {\n if (is_array($hour) || is_array($minute) || is_array($second)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $hour, $minute, $second);\n }\n\n try {\n $hour = self::toIntWithNullBool($hour);\n $minute = self::toIntWithNullBool($minute);\n $second = self::toIntWithNullBool($second);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n self::adjustSecond($second, $minute);\n self::adjustMinute($minute, $hour);\n\n if ($hour > 23) {\n $hour = $hour % 24;\n } elseif ($hour < 0) {\n return ExcelError::NAN();\n }\n\n // Execute function\n $retType = Functions::getReturnDateType();\n if ($retType === Functions::RETURNDATE_EXCEL) {\n $calendar = SharedDateHelper::getExcelCalendar();\n $date = (int) ($calendar !== SharedDateHelper::CALENDAR_WINDOWS_1900);\n\n return (float) SharedDateHelper::formattedPHPToExcel($calendar, 1, $date, $hour, $minute, $second);\n }\n if ($retType === Functions::RETURNDATE_UNIX_TIMESTAMP) {\n return (int) SharedDateHelper::excelToTimestamp(SharedDateHelper::formattedPHPToExcel(1970, 1, 1, $hour, $minute, $second)); // -2147468400; // -2147472000 + 3600\n }\n // RETURNDATE_PHP_DATETIME_OBJECT\n // Hour has already been normalized (0-23) above\n $phpDateObject = new DateTime('1900-01-01 ' . $hour . ':' . $minute . ':' . $second);\n\n return $phpDateObject;\n }\n\n private static function adjustSecond(int &$second, int &$minute): void\n {\n if ($second < 0) {\n $minute += (int) floor($second / 60);\n $second = 60 - abs($second % 60);\n if ($second == 60) {\n $second = 0;\n }\n } elseif ($second >= 60) {\n $minute += intdiv($second, 60);\n $second = $second % 60;\n }\n }\n\n private static function adjustMinute(int &$minute, int &$hour): void\n {\n if ($minute < 0) {\n $hour += (int) floor($minute / 60);\n $minute = 60 - abs($minute % 60);\n if ($minute == 60) {\n $minute = 0;\n }\n } elseif ($minute >= 60) {\n $hour += intdiv($minute, 60);\n $minute = $minute % 60;\n }\n }\n\n /**\n * @param mixed $value expect int\n */\n private static function toIntWithNullBool(mixed $value): int\n {\n $value = $value ?? 0;\n if (is_bool($value)) {\n $value = (int) $value;\n }\n if (!is_numeric($value)) {\n throw new Exception(ExcelError::VALUE());\n }\n\n return (int) $value;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/DateTimeExcel/TimeParts.php",
"content": "|int|string Hour\n * If an array of numbers is passed as the argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function hour(mixed $timeValue): array|string|int\n {\n if (is_array($timeValue)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $timeValue);\n }\n\n try {\n Helpers::nullFalseTrueToNumber($timeValue);\n if (is_string($timeValue) && !is_numeric($timeValue)) {\n $timeValue = Helpers::getTimeValue($timeValue);\n }\n Helpers::validateNotNegative($timeValue);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n // Execute function\n try {\n SharedDateHelper::excelToDateTimeObject($timeValue);\n } catch (Throwable) {\n return ExcelError::NAN();\n }\n $timeValue = fmod($timeValue, 1);\n $timeValue = SharedDateHelper::excelToDateTimeObject($timeValue);\n SharedDateHelper::roundMicroseconds($timeValue);\n\n return (int) $timeValue->format('H');\n }\n\n /**\n * MINUTE.\n *\n * Returns the minutes of a time value.\n * The minute is given as an integer, ranging from 0 to 59.\n *\n * Excel Function:\n * MINUTE(timeValue)\n *\n * @param mixed $timeValue Excel date serial value (float), PHP date timestamp (integer),\n * PHP DateTime object, or a standard time string\n * Or can be an array of date/time values\n *\n * @return array|int|string Minute\n * If an array of numbers is passed as the argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function minute(mixed $timeValue): array|string|int\n {\n if (is_array($timeValue)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $timeValue);\n }\n\n try {\n Helpers::nullFalseTrueToNumber($timeValue);\n if (is_string($timeValue) && !is_numeric($timeValue)) {\n $timeValue = Helpers::getTimeValue($timeValue);\n }\n Helpers::validateNotNegative($timeValue);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n // Execute function\n try {\n SharedDateHelper::excelToDateTimeObject($timeValue);\n } catch (Throwable) {\n return ExcelError::NAN();\n }\n $timeValue = fmod($timeValue, 1);\n $timeValue = SharedDateHelper::excelToDateTimeObject($timeValue);\n SharedDateHelper::roundMicroseconds($timeValue);\n\n return (int) $timeValue->format('i');\n }\n\n /**\n * SECOND.\n *\n * Returns the seconds of a time value.\n * The minute is given as an integer, ranging from 0 to 59.\n *\n * Excel Function:\n * SECOND(timeValue)\n *\n * @param mixed $timeValue Excel date serial value (float), PHP date timestamp (integer),\n * PHP DateTime object, or a standard time string\n * Or can be an array of date/time values\n *\n * @return array|int|string Second\n * If an array of numbers is passed as the argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function second(mixed $timeValue): array|string|int\n {\n if (is_array($timeValue)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $timeValue);\n }\n\n try {\n Helpers::nullFalseTrueToNumber($timeValue);\n if (is_string($timeValue) && !is_numeric($timeValue)) {\n $timeValue = Helpers::getTimeValue($timeValue);\n }\n Helpers::validateNotNegative($timeValue);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n // Execute function\n try {\n SharedDateHelper::excelToDateTimeObject($timeValue);\n } catch (Throwable) {\n return ExcelError::NAN();\n }\n $timeValue = fmod($timeValue, 1);\n $timeValue = SharedDateHelper::excelToDateTimeObject($timeValue);\n SharedDateHelper::roundMicroseconds($timeValue);\n\n return (int) $timeValue->format('s');\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/DateTimeExcel/TimeValue.php",
"content": "|bool|float|int|string $timeValue A text string that represents a time in any one of the Microsoft\n * Excel time formats; for example, \"6:45 PM\" and \"18:45\" text strings\n * within quotation marks that represent time.\n * Date information in time_text is ignored.\n * Or can be an array of date/time values\n *\n * @return array|DateTime|float|int|string Excel date/time serial value, PHP date/time serial value or PHP date/time object,\n * depending on the value of the ReturnDateType flag\n * If an array of numbers is passed as the argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function fromString(null|array|string|int|bool|float $timeValue): array|string|DateTime|int|float\n {\n if (is_array($timeValue)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $timeValue);\n }\n\n // try to parse as time iff there is at least one digit\n if (is_string($timeValue) && !Preg::isMatch('/\\d/', $timeValue)) {\n return ExcelError::VALUE();\n }\n\n $timeValue = trim((string) $timeValue, '\"');\n if (Preg::isMatch(self::EXTRACT_TIME, $timeValue, $matches)) {\n if (empty($matches[6])) { // am/pm\n $hour = (int) $matches[0];\n $timeValue = ($hour % 24) . $matches[2];\n } elseif ($matches[6] === $matches[7]) { // Excel wants space before am/pm\n return ExcelError::VALUE();\n } else {\n $timeValue = $matches[0] . 'm';\n }\n }\n\n $PHPDateArray = Helpers::dateParse($timeValue);\n $retValue = ExcelError::VALUE();\n if (Helpers::dateParseSucceeded($PHPDateArray)) {\n $hour = $PHPDateArray['hour'];\n $minute = $PHPDateArray['minute'];\n $second = $PHPDateArray['second'];\n // OpenOffice-specific code removed - it works just like Excel\n $excelDateValue = SharedDateHelper::formattedPHPToExcel(1900, 1, 1, $hour, $minute, $second) - 1;\n\n $retType = Functions::getReturnDateType();\n if ($retType === Functions::RETURNDATE_EXCEL) {\n $retValue = (float) $excelDateValue;\n } elseif ($retType === Functions::RETURNDATE_UNIX_TIMESTAMP) {\n $retValue = (int) SharedDateHelper::excelToTimestamp($excelDateValue + 25569) - 3600;\n } else {\n $retValue = new DateTime('1900-01-01 ' . $PHPDateArray['hour'] . ':' . $PHPDateArray['minute'] . ':' . $PHPDateArray['second']);\n }\n }\n\n return $retValue;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/DateTimeExcel/Week.php",
"content": "|int $method Week begins on Sunday or Monday\n * 1 or omitted Week begins on Sunday.\n * 2 Week begins on Monday.\n * 11 Week begins on Monday.\n * 12 Week begins on Tuesday.\n * 13 Week begins on Wednesday.\n * 14 Week begins on Thursday.\n * 15 Week begins on Friday.\n * 16 Week begins on Saturday.\n * 17 Week begins on Sunday.\n * 21 ISO (Jan. 4 is week 1, begins on Monday).\n * Or can be an array of methods\n *\n * @return array|int|string Week Number\n * If an array of values is passed as the argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function number(mixed $dateValue, array|int|string|null $method = Constants::STARTWEEK_SUNDAY): array|int|string\n {\n if (is_array($dateValue) || is_array($method)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $dateValue, $method);\n }\n\n $origDateValueNull = empty($dateValue);\n\n try {\n $method = self::validateMethod($method);\n if ($dateValue === null) { // boolean not allowed\n $dateValue = (SharedDateHelper::getExcelCalendar() === SharedDateHelper::CALENDAR_MAC_1904 || $method === Constants::DOW_SUNDAY) ? 0 : 1;\n }\n $dateValue = self::validateDateValue($dateValue);\n if (!$dateValue && self::buggyWeekNum1900($method)) {\n // This seems to be an additional Excel bug.\n return 0;\n }\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n // Execute function\n $PHPDateObject = SharedDateHelper::excelToDateTimeObject($dateValue);\n if ($method == Constants::STARTWEEK_MONDAY_ISO) {\n Helpers::silly1900($PHPDateObject);\n\n return (int) $PHPDateObject->format('W');\n }\n if (self::buggyWeekNum1904($method, $origDateValueNull, $PHPDateObject)) {\n return 0;\n }\n Helpers::silly1900($PHPDateObject, '+ 5 years'); // 1905 calendar matches\n $dayOfYear = (int) $PHPDateObject->format('z');\n $PHPDateObject->modify('-' . $dayOfYear . ' days');\n $firstDayOfFirstWeek = (int) $PHPDateObject->format('w');\n $daysInFirstWeek = (6 - $firstDayOfFirstWeek + $method) % 7;\n $daysInFirstWeek += 7 * !$daysInFirstWeek;\n $endFirstWeek = $daysInFirstWeek - 1;\n $weekOfYear = floor(($dayOfYear - $endFirstWeek + 13) / 7);\n\n return (int) $weekOfYear;\n }\n\n /**\n * ISOWEEKNUM.\n *\n * Returns the ISO 8601 week number of the year for a specified date.\n *\n * Excel Function:\n * ISOWEEKNUM(dateValue)\n *\n * @param mixed $dateValue Excel date serial value (float), PHP date timestamp (integer),\n * PHP DateTime object, or a standard date string\n * Or can be an array of date values\n *\n * @return array|int|string Week Number\n * If an array of numbers is passed as the argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function isoWeekNumber(mixed $dateValue): array|int|string\n {\n if (is_array($dateValue)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $dateValue);\n }\n\n if (self::apparentBug($dateValue)) {\n return 52;\n }\n\n try {\n $dateValue = Helpers::getDateValue($dateValue);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n // Execute function\n $PHPDateObject = SharedDateHelper::excelToDateTimeObject($dateValue);\n Helpers::silly1900($PHPDateObject);\n\n return (int) $PHPDateObject->format('W');\n }\n\n /**\n * WEEKDAY.\n *\n * Returns the day of the week for a specified date. The day is given as an integer\n * ranging from 0 to 7 (dependent on the requested style).\n *\n * Excel Function:\n * WEEKDAY(dateValue[,style])\n *\n * @param null|array|bool|float|int|string $dateValue Excel date serial value (float), PHP date timestamp (integer),\n * PHP DateTime object, or a standard date string\n * Or can be an array of date values\n * @param mixed $style A number that determines the type of return value\n * 1 or omitted Numbers 1 (Sunday) through 7 (Saturday).\n * 2 Numbers 1 (Monday) through 7 (Sunday).\n * 3 Numbers 0 (Monday) through 6 (Sunday).\n * Or can be an array of styles\n *\n * @return array|int|string Day of the week value\n * If an array of values is passed as the argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function day(null|array|float|int|string|bool $dateValue, mixed $style = 1): array|string|int\n {\n if (is_array($dateValue) || is_array($style)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $dateValue, $style);\n }\n\n try {\n $dateValue = Helpers::getDateValue($dateValue);\n $style = self::validateStyle($style);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n // Execute function\n $PHPDateObject = SharedDateHelper::excelToDateTimeObject($dateValue);\n Helpers::silly1900($PHPDateObject);\n $DoW = (int) $PHPDateObject->format('w');\n\n switch ($style) {\n case 1:\n ++$DoW;\n\n break;\n case 2:\n $DoW = self::dow0Becomes7($DoW);\n\n break;\n case 3:\n $DoW = self::dow0Becomes7($DoW) - 1;\n\n break;\n }\n\n return $DoW;\n }\n\n /**\n * @param mixed $style expect int\n */\n private static function validateStyle(mixed $style): int\n {\n if (!is_numeric($style)) {\n throw new Exception(ExcelError::VALUE());\n }\n $style = (int) $style;\n if (($style < 1) || ($style > 3)) {\n throw new Exception(ExcelError::NAN());\n }\n\n return $style;\n }\n\n private static function dow0Becomes7(int $DoW): int\n {\n return ($DoW === 0) ? 7 : $DoW;\n }\n\n /**\n * @param mixed $dateValue Excel date serial value (float), PHP date timestamp (integer),\n * PHP DateTime object, or a standard date string\n */\n private static function apparentBug(mixed $dateValue): bool\n {\n if (SharedDateHelper::getExcelCalendar() !== SharedDateHelper::CALENDAR_MAC_1904) {\n if (is_bool($dateValue)) {\n return true;\n }\n if (is_numeric($dateValue) && !((int) $dateValue)) {\n return true;\n }\n }\n\n return false;\n }\n\n /**\n * Validate dateValue parameter.\n */\n private static function validateDateValue(mixed $dateValue): float\n {\n if (is_bool($dateValue)) {\n throw new Exception(ExcelError::VALUE());\n }\n\n return Helpers::getDateValue($dateValue);\n }\n\n /**\n * Validate method parameter.\n */\n private static function validateMethod(mixed $method): int\n {\n if ($method === null) {\n $method = Constants::STARTWEEK_SUNDAY;\n }\n\n if (!is_numeric($method)) {\n throw new Exception(ExcelError::VALUE());\n }\n\n $method = (int) $method;\n if (!array_key_exists($method, Constants::METHODARR)) {\n throw new Exception(ExcelError::NAN());\n }\n $method = Constants::METHODARR[$method];\n\n return $method;\n }\n\n private static function buggyWeekNum1900(int $method): bool\n {\n return $method === Constants::DOW_SUNDAY && SharedDateHelper::getExcelCalendar() === SharedDateHelper::CALENDAR_WINDOWS_1900;\n }\n\n private static function buggyWeekNum1904(int $method, bool $origNull, DateTime $dateObject): bool\n {\n // This appears to be another Excel bug.\n\n return $method === Constants::DOW_SUNDAY && SharedDateHelper::getExcelCalendar() === SharedDateHelper::CALENDAR_MAC_1904\n && !$origNull && $dateObject->format('Y-m-d') === '1904-01-01';\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/DateTimeExcel/WorkDay.php",
"content": "|mixed $startDate Excel date serial value (float), PHP date timestamp (integer),\n * PHP DateTime object, or a standard date string\n * Or can be an array of date values\n * @param array|int $endDays The number of nonweekend and nonholiday days before or after\n * startDate. A positive value for days yields a future date; a\n * negative value yields a past date.\n * Or can be an array of int values\n * @param null|mixed $dateArgs An array of dates (such as holidays) to exclude from the calculation\n *\n * @return array|DateTime|float|int|string Excel date/time serial value, PHP date/time serial value or PHP date/time object,\n * depending on the value of the ReturnDateType flag\n * If an array of values is passed for the $startDate or $endDays,arguments, then the returned result\n * will also be an array with matching dimensions\n */\n public static function date(mixed $startDate, array|int|string $endDays, mixed ...$dateArgs): array|float|int|DateTime|string\n {\n if (is_array($startDate) || is_array($endDays)) {\n return self::evaluateArrayArgumentsSubset(\n [self::class, __FUNCTION__],\n 2,\n $startDate,\n $endDays,\n ...$dateArgs\n );\n }\n\n // Retrieve the mandatory start date and days that are referenced in the function definition\n try {\n $startDate = Helpers::getDateValue($startDate);\n $endDays = Helpers::validateNumericNull($endDays);\n $holidayArray = array_map([Helpers::class, 'getDateValue'], Functions::flattenArray($dateArgs));\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n $startDate = (float) floor($startDate);\n $endDays = (int) floor($endDays);\n // If endDays is 0, we always return startDate\n if ($endDays == 0) {\n return $startDate;\n }\n if ($endDays < 0) {\n return self::decrementing($startDate, $endDays, $holidayArray);\n }\n\n return self::incrementing($startDate, $endDays, $holidayArray);\n }\n\n /**\n * Use incrementing logic to determine Workday.\n *\n * @param array $holidayArray\n */\n private static function incrementing(float $startDate, int $endDays, array $holidayArray): float|int|DateTime\n {\n // Adjust the start date if it falls over a weekend\n $startDoW = self::getWeekDay($startDate, 3);\n if ($startDoW >= 5) {\n $startDate += 7 - $startDoW;\n --$endDays;\n }\n\n // Add endDays\n $endDate = (float) $startDate + ((int) ($endDays / 5) * 7);\n $endDays = $endDays % 5;\n while ($endDays > 0) {\n ++$endDate;\n // Adjust the calculated end date if it falls over a weekend\n $endDow = self::getWeekDay($endDate, 3);\n if ($endDow >= 5) {\n $endDate += 7 - $endDow;\n }\n --$endDays;\n }\n\n // Test any extra holiday parameters\n if (!empty($holidayArray)) {\n $endDate = self::incrementingArray($startDate, $endDate, $holidayArray);\n }\n\n return Helpers::returnIn3FormatsFloat($endDate);\n }\n\n /** @param array $holidayArray */\n private static function incrementingArray(float $startDate, float $endDate, array $holidayArray): float\n {\n $holidayCountedArray = $holidayDates = [];\n foreach ($holidayArray as $holidayDate) {\n /** @var float $holidayDate */\n if (self::getWeekDay($holidayDate, 3) < 5) {\n $holidayDates[] = $holidayDate;\n }\n }\n sort($holidayDates, SORT_NUMERIC);\n foreach ($holidayDates as $holidayDate) {\n if (($holidayDate >= $startDate) && ($holidayDate <= $endDate)) {\n if (!in_array($holidayDate, $holidayCountedArray)) {\n ++$endDate;\n $holidayCountedArray[] = $holidayDate;\n }\n }\n // Adjust the calculated end date if it falls over a weekend\n $endDoW = self::getWeekDay($endDate, 3);\n if ($endDoW >= 5) {\n $endDate += 7 - $endDoW;\n }\n }\n\n return $endDate;\n }\n\n /**\n * Use decrementing logic to determine Workday.\n *\n * @param array $holidayArray\n */\n private static function decrementing(float $startDate, int $endDays, array $holidayArray): float|int|DateTime\n {\n // Adjust the start date if it falls over a weekend\n $startDoW = self::getWeekDay($startDate, 3);\n if ($startDoW >= 5) {\n $startDate += -$startDoW + 4;\n ++$endDays;\n }\n\n // Add endDays\n $endDate = (float) $startDate + ((int) ($endDays / 5) * 7);\n $endDays = $endDays % 5;\n while ($endDays < 0) {\n --$endDate;\n // Adjust the calculated end date if it falls over a weekend\n $endDow = self::getWeekDay($endDate, 3);\n if ($endDow >= 5) {\n $endDate += 4 - $endDow;\n }\n ++$endDays;\n }\n\n // Test any extra holiday parameters\n if (!empty($holidayArray)) {\n $endDate = self::decrementingArray($startDate, $endDate, $holidayArray);\n }\n\n return Helpers::returnIn3FormatsFloat($endDate);\n }\n\n /** @param array $holidayArray */\n private static function decrementingArray(float $startDate, float $endDate, array $holidayArray): float\n {\n $holidayCountedArray = $holidayDates = [];\n foreach ($holidayArray as $holidayDate) {\n /** @var float $holidayDate */\n if (self::getWeekDay($holidayDate, 3) < 5) {\n $holidayDates[] = $holidayDate;\n }\n }\n rsort($holidayDates, SORT_NUMERIC);\n foreach ($holidayDates as $holidayDate) {\n if (($holidayDate <= $startDate) && ($holidayDate >= $endDate)) {\n if (!in_array($holidayDate, $holidayCountedArray)) {\n --$endDate;\n $holidayCountedArray[] = $holidayDate;\n }\n }\n // Adjust the calculated end date if it falls over a weekend\n $endDoW = self::getWeekDay($endDate, 3);\n /** int $endDoW */\n if ($endDoW >= 5) {\n $endDate += -$endDoW + 4;\n }\n }\n\n return $endDate;\n }\n\n private static function getWeekDay(float $date, int $wd): int\n {\n $result = Functions::scalar(Week::day($date, $wd));\n\n return is_int($result) ? $result : -1;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/DateTimeExcel/YearFrac.php",
"content": "|int $method Method used for the calculation\n * 0 or omitted US (NASD) 30/360\n * 1 Actual/actual\n * 2 Actual/360\n * 3 Actual/365\n * 4 European 30/360\n * Or can be an array of methods\n *\n * @return array|float|int|string fraction of the year, or a string containing an error\n * If an array of values is passed for the $startDate or $endDays,arguments, then the returned result\n * will also be an array with matching dimensions\n */\n public static function fraction(mixed $startDate, mixed $endDate, array|int|string|null $method = 0): array|string|int|float\n {\n if (is_array($startDate) || is_array($endDate) || is_array($method)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $startDate, $endDate, $method);\n }\n\n try {\n $method = (int) Helpers::validateNumericNull($method);\n $sDate = Helpers::getDateValue($startDate);\n $eDate = Helpers::getDateValue($endDate);\n $sDate = self::excelBug($sDate, $startDate, $endDate, $method);\n $eDate = self::excelBug($eDate, $endDate, $startDate, $method);\n $startDate = min($sDate, $eDate);\n $endDate = max($sDate, $eDate);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n return match ($method) {\n 0 => Helpers::floatOrInt(Days360::between($startDate, $endDate)) / 360,\n 1 => self::method1($startDate, $endDate),\n 2 => Helpers::floatOrInt(Difference::interval($startDate, $endDate)) / 360,\n 3 => Helpers::floatOrInt(Difference::interval($startDate, $endDate)) / 365,\n 4 => Helpers::floatOrInt(Days360::between($startDate, $endDate, true)) / 360,\n default => ExcelError::NAN(),\n };\n }\n\n /**\n * Excel 1900 calendar treats date argument of null as 1900-01-00. Really.\n */\n private static function excelBug(float $sDate, mixed $startDate, mixed $endDate, int $method): float\n {\n if (Functions::getCompatibilityMode() !== Functions::COMPATIBILITY_OPENOFFICE && SharedDateHelper::getExcelCalendar() !== SharedDateHelper::CALENDAR_MAC_1904) {\n if ($endDate === null && $startDate !== null) {\n if (DateParts::month($sDate) == 12 && DateParts::day($sDate) === 31 && $method === 0) {\n $sDate += 2;\n } else {\n ++$sDate;\n }\n }\n }\n\n return $sDate;\n }\n\n private static function method1(float $startDate, float $endDate): float\n {\n $days = Helpers::floatOrInt(Difference::interval($startDate, $endDate));\n $startYear = (int) DateParts::year($startDate);\n $endYear = (int) DateParts::year($endDate);\n $years = $endYear - $startYear + 1;\n $startMonth = (int) DateParts::month($startDate);\n $startDay = (int) DateParts::day($startDate);\n $endMonth = (int) DateParts::month($endDate);\n $endDay = (int) DateParts::day($endDate);\n $startMonthDay = 100 * $startMonth + $startDay;\n $endMonthDay = 100 * $endMonth + $endDay;\n if ($years == 1) {\n $tmpCalcAnnualBasis = 365 + (int) Helpers::isLeapYear($endYear);\n } elseif ($years == 2 && $startMonthDay >= $endMonthDay) {\n if (Helpers::isLeapYear($startYear)) {\n $tmpCalcAnnualBasis = 365 + (int) ($startMonthDay <= 229);\n } elseif (Helpers::isLeapYear($endYear)) {\n $tmpCalcAnnualBasis = 365 + (int) ($endMonthDay >= 229);\n } else {\n $tmpCalcAnnualBasis = 365;\n }\n } else {\n $tmpCalcAnnualBasis = 0;\n for ($year = $startYear; $year <= $endYear; ++$year) {\n $tmpCalcAnnualBasis += 365 + (int) Helpers::isLeapYear($year);\n }\n $tmpCalcAnnualBasis /= $years;\n }\n\n return $days / $tmpCalcAnnualBasis;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engine/ArrayArgumentHelper.php",
"content": "indexStart = (int) array_shift($keys);\n $this->rows = $this->rows($arguments);\n $this->columns = $this->columns($arguments);\n\n $this->argumentCount = count($arguments);\n $this->arguments = $this->flattenSingleCellArrays($arguments, $this->rows, $this->columns);\n\n $this->rows = $this->rows($arguments);\n $this->columns = $this->columns($arguments);\n\n if ($this->arrayArguments() > 2) {\n throw new Exception('Formulae with more than two array arguments are not supported');\n }\n }\n\n /** @return mixed[] */\n public function arguments(): array\n {\n return $this->arguments;\n }\n\n public function hasArrayArgument(): bool\n {\n return $this->arrayArguments() > 0;\n }\n\n public function getFirstArrayArgumentNumber(): int\n {\n $rowArrays = $this->filterArray($this->rows);\n $columnArrays = $this->filterArray($this->columns);\n\n for ($index = $this->indexStart; $index < $this->argumentCount; ++$index) {\n if (isset($rowArrays[$index]) || isset($columnArrays[$index])) {\n return ++$index;\n }\n }\n\n return 0;\n }\n\n public function getSingleRowVector(): ?int\n {\n $rowVectors = $this->getRowVectors();\n\n return count($rowVectors) === 1 ? array_pop($rowVectors) : null;\n }\n\n /** @return int[] */\n private function getRowVectors(): array\n {\n $rowVectors = [];\n for ($index = $this->indexStart; $index < ($this->indexStart + $this->argumentCount); ++$index) {\n if ($this->rows[$index] === 1 && $this->columns[$index] > 1) {\n $rowVectors[] = $index;\n }\n }\n\n return $rowVectors;\n }\n\n public function getSingleColumnVector(): ?int\n {\n $columnVectors = $this->getColumnVectors();\n\n return count($columnVectors) === 1 ? array_pop($columnVectors) : null;\n }\n\n /** @return int[] */\n private function getColumnVectors(): array\n {\n $columnVectors = [];\n for ($index = $this->indexStart; $index < ($this->indexStart + $this->argumentCount); ++$index) {\n if ($this->rows[$index] > 1 && $this->columns[$index] === 1) {\n $columnVectors[] = $index;\n }\n }\n\n return $columnVectors;\n }\n\n /** @return int[] */\n public function getMatrixPair(): array\n {\n for ($i = $this->indexStart; $i < ($this->indexStart + $this->argumentCount - 1); ++$i) {\n for ($j = $i + 1; $j < $this->argumentCount; ++$j) {\n if (isset($this->rows[$i], $this->rows[$j])) {\n return [$i, $j];\n }\n }\n }\n\n return [];\n }\n\n public function isVector(int $argument): bool\n {\n return $this->rows[$argument] === 1 || $this->columns[$argument] === 1;\n }\n\n public function isRowVector(int $argument): bool\n {\n return $this->rows[$argument] === 1;\n }\n\n public function isColumnVector(int $argument): bool\n {\n return $this->columns[$argument] === 1;\n }\n\n public function rowCount(int $argument): int\n {\n return $this->rows[$argument];\n }\n\n public function columnCount(int $argument): int\n {\n return $this->columns[$argument];\n }\n\n /**\n * @param mixed[] $arguments\n *\n * @return int[]\n */\n private function rows(array $arguments): array\n {\n return array_map(\n fn ($argument): int => is_countable($argument) ? count($argument) : 1,\n $arguments\n );\n }\n\n /**\n * @param mixed[] $arguments\n *\n * @return int[]\n */\n private function columns(array $arguments): array\n {\n return array_map(\n fn (mixed $argument): int => is_array($argument) && is_array($argument[array_keys($argument)[0]])\n ? count($argument[array_keys($argument)[0]])\n : 1,\n $arguments\n );\n }\n\n public function arrayArguments(): int\n {\n $count = 0;\n foreach (array_keys($this->arguments) as $argument) {\n if ($this->rows[$argument] > 1 || $this->columns[$argument] > 1) {\n ++$count;\n }\n }\n\n return $count;\n }\n\n /**\n * @param mixed[] $arguments\n * @param int[] $rows\n * @param int[] $columns\n *\n * @return mixed[]\n */\n private function flattenSingleCellArrays(array $arguments, array $rows, array $columns): array\n {\n foreach ($arguments as $index => $argument) {\n if ($rows[$index] === 1 && $columns[$index] === 1) {\n while (is_array($argument)) {\n $argument = array_pop($argument);\n }\n $arguments[$index] = $argument;\n }\n }\n\n return $arguments;\n }\n\n /**\n * @param mixed[] $array\n *\n * @return mixed[]\n */\n private function filterArray(array $array): array\n {\n return array_filter(\n $array,\n fn ($value): bool => $value > 1\n );\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engine/ArrayArgumentProcessor.php",
"content": "hasArrayArgument() === false) {\n return [$method(...$arguments)];\n }\n\n if (self::$arrayArgumentHelper->arrayArguments() === 1) {\n $nthArgument = self::$arrayArgumentHelper->getFirstArrayArgumentNumber();\n\n return self::evaluateNthArgumentAsArray($method, $nthArgument, ...$arguments);\n }\n\n $singleRowVectorIndex = self::$arrayArgumentHelper->getSingleRowVector();\n $singleColumnVectorIndex = self::$arrayArgumentHelper->getSingleColumnVector();\n\n if ($singleRowVectorIndex !== null && $singleColumnVectorIndex !== null) {\n // Basic logic for a single row vector and a single column vector\n return self::evaluateVectorPair($method, $singleRowVectorIndex, $singleColumnVectorIndex, ...$arguments);\n }\n\n $matrixPair = self::$arrayArgumentHelper->getMatrixPair();\n if ($matrixPair !== []) {\n if (\n (self::$arrayArgumentHelper->isVector($matrixPair[0]) === true\n && self::$arrayArgumentHelper->isVector($matrixPair[1]) === false)\n || (self::$arrayArgumentHelper->isVector($matrixPair[0]) === false\n && self::$arrayArgumentHelper->isVector($matrixPair[1]) === true)\n ) {\n // Logic for a matrix and a vector (row or column)\n return self::evaluateVectorMatrixPair($method, $matrixPair, ...$arguments);\n }\n\n // Logic for matrix/matrix, column vector/column vector or row vector/row vector\n return self::evaluateMatrixPair($method, $matrixPair, ...$arguments);\n }\n\n // Still need to work out the logic for more than two array arguments,\n // For the moment, we're throwing an Exception when we initialise the ArrayArgumentHelper\n return ['#VALUE!'];\n }\n\n /**\n * @param int[] $matrixIndexes\n *\n * @return mixed[]\n */\n private static function evaluateVectorMatrixPair(callable $method, array $matrixIndexes, mixed ...$arguments): array\n {\n $matrix2 = array_pop($matrixIndexes) ?? throw new Exception('empty array 2');\n /** @var mixed[][] $matrixValues2 */\n $matrixValues2 = $arguments[$matrix2];\n $matrix1 = array_pop($matrixIndexes) ?? throw new Exception('empty array 1');\n /** @var mixed[][] $matrixValues1 */\n $matrixValues1 = $arguments[$matrix1];\n\n /** @var non-empty-array */\n $matrix12 = [$matrix1, $matrix2];\n $rows = min(array_map(self::$arrayArgumentHelper->rowCount(...), $matrix12));\n $columns = min(array_map(self::$arrayArgumentHelper->columnCount(...), $matrix12));\n\n if ($rows === 1) {\n $rows = max(array_map(self::$arrayArgumentHelper->rowCount(...), $matrix12));\n }\n if ($columns === 1) {\n $columns = max(array_map(self::$arrayArgumentHelper->columnCount(...), $matrix12));\n }\n\n $result = [];\n for ($rowIndex = 0; $rowIndex < $rows; ++$rowIndex) {\n for ($columnIndex = 0; $columnIndex < $columns; ++$columnIndex) {\n $rowIndex1 = self::$arrayArgumentHelper->isRowVector($matrix1) ? 0 : $rowIndex;\n $columnIndex1 = self::$arrayArgumentHelper->isColumnVector($matrix1) ? 0 : $columnIndex;\n $value1 = $matrixValues1[$rowIndex1][$columnIndex1];\n $rowIndex2 = self::$arrayArgumentHelper->isRowVector($matrix2) ? 0 : $rowIndex;\n $columnIndex2 = self::$arrayArgumentHelper->isColumnVector($matrix2) ? 0 : $columnIndex;\n $value2 = $matrixValues2[$rowIndex2][$columnIndex2];\n $arguments[$matrix1] = $value1;\n $arguments[$matrix2] = $value2;\n\n $result[$rowIndex][$columnIndex] = $method(...$arguments);\n }\n }\n\n return $result;\n }\n\n /**\n * @param array $matrixIndexes\n *\n * @return mixed[]\n */\n private static function evaluateMatrixPair(callable $method, array $matrixIndexes, mixed ...$arguments): array\n {\n $matrix2 = array_pop($matrixIndexes);\n /** @var mixed[][] $matrixValues2 */\n $matrixValues2 = $arguments[$matrix2];\n $matrix1 = array_pop($matrixIndexes);\n /** @var mixed[][] $matrixValues1 */\n $matrixValues1 = $arguments[$matrix1];\n\n $result = [];\n foreach ($matrixValues1 as $rowIndex => $row) {\n foreach ($row as $columnIndex => $value1) {\n if (isset($matrixValues2[$rowIndex][$columnIndex]) === false) {\n continue;\n }\n\n $value2 = $matrixValues2[$rowIndex][$columnIndex];\n $arguments[$matrix1] = $value1;\n $arguments[$matrix2] = $value2;\n\n $result[$rowIndex][$columnIndex] = $method(...$arguments);\n }\n }\n\n return $result;\n }\n\n /** @return mixed[] */\n private static function evaluateVectorPair(callable $method, int $rowIndex, int $columnIndex, mixed ...$arguments): array\n {\n $rowVector = Functions::flattenArray($arguments[$rowIndex]);\n $columnVector = Functions::flattenArray($arguments[$columnIndex]);\n\n $result = [];\n foreach ($columnVector as $column) {\n $rowResults = [];\n foreach ($rowVector as $row) {\n $arguments[$rowIndex] = $row;\n $arguments[$columnIndex] = $column;\n\n $rowResults[] = $method(...$arguments);\n }\n $result[] = $rowResults;\n }\n\n return $result;\n }\n\n /**\n * Note, offset is from 1 (for the first argument) rather than from 0.\n *\n * @return mixed[]\n */\n private static function evaluateNthArgumentAsArray(callable $method, int $nthArgument, mixed ...$arguments): array\n {\n $values = array_slice($arguments, $nthArgument - 1, 1);\n /** @var mixed[] $values */\n $values = array_pop($values);\n\n $result = [];\n foreach ($values as $value) {\n $arguments[$nthArgument - 1] = $value;\n $result[] = $method(...$arguments);\n }\n\n return $result;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engine/BranchPruner.php",
"content": "branchPruningEnabled = $branchPruningEnabled;\n }\n\n public function clearBranchStore(): void\n {\n $this->branchStoreKeyCounter = 0;\n }\n\n public function initialiseForLoop(): void\n {\n $this->currentCondition = null;\n $this->currentOnlyIf = null;\n $this->currentOnlyIfNot = null;\n $this->previousStoreKey = null;\n $this->pendingStoreKey = empty($this->storeKeysStack) ? null : end($this->storeKeysStack);\n\n if ($this->branchPruningEnabled) {\n $this->initialiseCondition();\n $this->initialiseThen();\n $this->initialiseElse();\n }\n }\n\n private function initialiseCondition(): void\n {\n if (isset($this->pendingStoreKey, $this->conditionMap[$this->pendingStoreKey]) && $this->conditionMap[$this->pendingStoreKey]) {\n $this->currentCondition = $this->pendingStoreKey;\n $stackDepth = count($this->storeKeysStack);\n if ($stackDepth > 1) {\n // nested if\n $this->previousStoreKey = $this->storeKeysStack[$stackDepth - 2];\n }\n }\n }\n\n private function initialiseThen(): void\n {\n if (isset($this->pendingStoreKey, $this->thenMap[$this->pendingStoreKey]) && $this->thenMap[$this->pendingStoreKey]) {\n $this->currentOnlyIf = $this->pendingStoreKey;\n } elseif (\n isset($this->previousStoreKey, $this->thenMap[$this->previousStoreKey])\n && $this->thenMap[$this->previousStoreKey]\n ) {\n $this->currentOnlyIf = $this->previousStoreKey;\n }\n }\n\n private function initialiseElse(): void\n {\n if (isset($this->pendingStoreKey, $this->elseMap[$this->pendingStoreKey]) && $this->elseMap[$this->pendingStoreKey]) {\n $this->currentOnlyIfNot = $this->pendingStoreKey;\n } elseif (\n isset($this->previousStoreKey, $this->elseMap[$this->previousStoreKey])\n && $this->elseMap[$this->previousStoreKey]\n ) {\n $this->currentOnlyIfNot = $this->previousStoreKey;\n }\n }\n\n public function decrementDepth(): void\n {\n if (!empty($this->pendingStoreKey)) {\n --$this->braceDepthMap[$this->pendingStoreKey];\n }\n }\n\n public function incrementDepth(): void\n {\n if (!empty($this->pendingStoreKey)) {\n ++$this->braceDepthMap[$this->pendingStoreKey];\n }\n }\n\n public function functionCall(string $functionName): void\n {\n if ($this->branchPruningEnabled && ($functionName === 'IF(')) {\n // we handle a new if\n $this->pendingStoreKey = $this->getUnusedBranchStoreKey();\n $this->storeKeysStack[] = $this->pendingStoreKey;\n $this->conditionMap[$this->pendingStoreKey] = true;\n $this->braceDepthMap[$this->pendingStoreKey] = 0;\n } elseif (!empty($this->pendingStoreKey) && array_key_exists($this->pendingStoreKey, $this->braceDepthMap)) {\n // this is not an if but we go deeper\n ++$this->braceDepthMap[$this->pendingStoreKey];\n }\n }\n\n public function argumentSeparator(): void\n {\n if (!empty($this->pendingStoreKey) && $this->braceDepthMap[$this->pendingStoreKey] === 0) {\n // We must go to the IF next argument\n if ($this->conditionMap[$this->pendingStoreKey]) {\n $this->conditionMap[$this->pendingStoreKey] = false;\n $this->thenMap[$this->pendingStoreKey] = true;\n } elseif ($this->thenMap[$this->pendingStoreKey]) {\n $this->thenMap[$this->pendingStoreKey] = false;\n $this->elseMap[$this->pendingStoreKey] = true;\n } elseif ($this->elseMap[$this->pendingStoreKey]) {\n throw new Exception('Reaching fourth argument of an IF');\n }\n }\n }\n\n public function closingBrace(mixed $value): void\n {\n if (!empty($this->pendingStoreKey) && $this->braceDepthMap[$this->pendingStoreKey] === -1) {\n // we are closing an IF(\n if ($value !== 'IF(') {\n throw new Exception('Parser bug we should be in an \"IF(\"');\n }\n\n if ($this->conditionMap[$this->pendingStoreKey]) {\n throw new Exception('We should not be expecting a condition');\n }\n\n $this->thenMap[$this->pendingStoreKey] = false;\n $this->elseMap[$this->pendingStoreKey] = false;\n --$this->braceDepthMap[$this->pendingStoreKey];\n array_pop($this->storeKeysStack);\n $this->pendingStoreKey = null;\n }\n }\n\n public function currentCondition(): ?string\n {\n return $this->currentCondition;\n }\n\n public function currentOnlyIf(): ?string\n {\n return $this->currentOnlyIf;\n }\n\n public function currentOnlyIfNot(): ?string\n {\n return $this->currentOnlyIfNot;\n }\n\n private function getUnusedBranchStoreKey(): string\n {\n $storeKeyValue = 'storeKey-' . $this->branchStoreKeyCounter;\n ++$this->branchStoreKeyCounter;\n\n return $storeKeyValue;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engine/CyclicReferenceStack.php",
"content": "stack);\n }\n\n /**\n * Push a new entry onto the stack.\n *\n * @param int|string $value The value to test\n */\n public function push($value): void\n {\n $this->stack[$value] = $value;\n }\n\n /**\n * Pop the last entry from the stack.\n */\n public function pop(): mixed\n {\n return array_pop($this->stack);\n }\n\n /**\n * Test to see if a specified entry exists on the stack.\n *\n * @param int|string $value The value to test\n */\n public function onStack($value): bool\n {\n return isset($this->stack[$value]);\n }\n\n /**\n * Clear the stack.\n */\n public function clear(): void\n {\n $this->stack = [];\n }\n\n /**\n * Return an array of all entries on the stack.\n *\n * @return mixed[]\n */\n public function showStack(): array\n {\n return $this->stack;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engine/FormattedNumber.php",
"content": "[-+])? *\\% *(?[-+])? *(?[0-9]+\\.?[0-9*]*(?:E[-+]?[0-9]*)?) *)|(?: *(?[-+])? *(?[0-9]+\\.?[0-9]*(?:E[-+]?[0-9]*)?) *\\% *))$~i';\n\n // preg_quoted string for major currency symbols, with a %s for locale currency\n private const CURRENCY_CONVERSION_LIST = '\\$€£¥%s';\n\n /**\n * Identify whether a string contains a formatted numeric value,\n * and convert it to a numeric if it is.\n *\n * @param float|string $operand string value to test\n */\n public static function convertToNumberIfFormatted(float|string &$operand): bool\n {\n return self::convertToNumberIfNumeric($operand)\n || self::convertToNumberIfFraction($operand)\n || self::convertToNumberIfPercent($operand)\n || self::convertToNumberIfCurrency($operand);\n }\n\n /**\n * Identify whether a string contains a numeric value,\n * and convert it to a numeric if it is.\n *\n * @param float|string $operand string value to test\n */\n public static function convertToNumberIfNumeric(float|string &$operand): bool\n {\n $thousandsSeparator = preg_quote(StringHelper::getThousandsSeparator(), '/');\n $value = preg_replace(['/(\\d)' . $thousandsSeparator . '(\\d)/u', '/([+-])\\s+(\\d)/u'], ['$1$2', '$1$2'], trim(\"$operand\"));\n $decimalSeparator = preg_quote(StringHelper::getDecimalSeparator(), '/');\n $value = preg_replace(['/(\\d)' . $decimalSeparator . '(\\d)/u', '/([+-])\\s+(\\d)/u'], ['$1.$2', '$1$2'], $value ?? '');\n\n if (is_numeric($value)) {\n $operand = (float) $value;\n\n return true;\n }\n\n return false;\n }\n\n /**\n * Identify whether a string contains a fractional numeric value,\n * and convert it to a numeric if it is.\n *\n * @param string $operand string value to test\n */\n public static function convertToNumberIfFraction(float|string &$operand): bool\n {\n if (is_string($operand) && preg_match(self::STRING_REGEXP_FRACTION, $operand, $match)) {\n $sign = ($match[1] === '-') ? '-' : '+';\n $wholePart = ($match[3] === '') ? '' : ($sign . $match[3]);\n $fractionFormula = '=' . $wholePart . $sign . $match[4];\n /** @var string */\n $operandx = Calculation::getInstance()->_calculateFormulaValue($fractionFormula);\n $operand = $operandx;\n\n return true;\n }\n\n return false;\n }\n\n /**\n * Identify whether a string contains a percentage, and if so,\n * convert it to a numeric.\n *\n * @param float|string $operand string value to test\n */\n public static function convertToNumberIfPercent(float|string &$operand): bool\n {\n $thousandsSeparator = preg_quote(StringHelper::getThousandsSeparator(), '/');\n $value = preg_replace('/(\\d)' . $thousandsSeparator . '(\\d)/u', '$1$2', trim(\"$operand\"));\n $decimalSeparator = preg_quote(StringHelper::getDecimalSeparator(), '/');\n $value = preg_replace(['/(\\d)' . $decimalSeparator . '(\\d)/u', '/([+-])\\s+(\\d)/u'], ['$1.$2', '$1$2'], $value ?? '');\n\n $match = [];\n if ($value !== null && preg_match(self::STRING_REGEXP_PERCENT, $value, $match, PREG_UNMATCHED_AS_NULL)) {\n //Calculate the percentage\n $sign = ($match['PrefixedSign'] ?? $match['PrefixedSign2'] ?? $match['PostfixedSign']) ?? '';\n $operand = (float) ($sign . ($match['PostfixedValue'] ?? $match['PrefixedValue'])) / 100;\n\n return true;\n }\n\n return false;\n }\n\n /**\n * Identify whether a string contains a currency value, and if so,\n * convert it to a numeric.\n *\n * @param float|string $operand string value to test\n */\n public static function convertToNumberIfCurrency(float|string &$operand): bool\n {\n $currencyRegexp = self::currencyMatcherRegexp();\n $thousandsSeparator = preg_quote(StringHelper::getThousandsSeparator(), '/');\n $value = preg_replace('/(\\d)' . $thousandsSeparator . '(\\d)/u', '$1$2', \"$operand\");\n\n $match = [];\n if ($value !== null && preg_match($currencyRegexp, $value, $match, PREG_UNMATCHED_AS_NULL)) {\n //Determine the sign\n $sign = ($match['PrefixedSign'] ?? $match['PrefixedSign2'] ?? $match['PostfixedSign']) ?? '';\n $decimalSeparator = StringHelper::getDecimalSeparator();\n //Cast to a float\n $intermediate = (string) ($match['PostfixedValue'] ?? $match['PrefixedValue']);\n $intermediate = str_replace($decimalSeparator, '.', $intermediate);\n if (is_numeric($intermediate)) {\n $operand = (float) ($sign . str_replace($decimalSeparator, '.', $intermediate));\n\n return true;\n }\n }\n\n return false;\n }\n\n public static function currencyMatcherRegexp(): string\n {\n $currencyCodes = sprintf(self::CURRENCY_CONVERSION_LIST, preg_quote(StringHelper::getCurrencyCode(), '/'));\n $decimalSeparator = preg_quote(StringHelper::getDecimalSeparator(), '/');\n\n return '~^(?:(?: *(?[-+])? *(?[' . $currencyCodes . ']) *(?[-+])? *(?[0-9]+[' . $decimalSeparator . ']?[0-9*]*(?:E[-+]?[0-9]*)?) *)|(?: *(?[-+])? *(?[0-9]+' . $decimalSeparator . '?[0-9]*(?:E[-+]?[0-9]*)?) *(?[' . $currencyCodes . ']) *))$~ui';\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engine/Logger.php",
"content": "cellStack = $stack;\n }\n\n /**\n * Enable/Disable Calculation engine logging.\n */\n public function setWriteDebugLog(bool $writeDebugLog): void\n {\n $this->writeDebugLog = $writeDebugLog;\n }\n\n /**\n * Return whether calculation engine logging is enabled or disabled.\n */\n public function getWriteDebugLog(): bool\n {\n return $this->writeDebugLog;\n }\n\n /**\n * Enable/Disable echoing of debug log information.\n */\n public function setEchoDebugLog(bool $echoDebugLog): void\n {\n $this->echoDebugLog = $echoDebugLog;\n }\n\n /**\n * Return whether echoing of debug log information is enabled or disabled.\n */\n public function getEchoDebugLog(): bool\n {\n return $this->echoDebugLog;\n }\n\n /**\n * Write an entry to the calculation engine debug log.\n */\n public function writeDebugLog(string $message, mixed ...$args): void\n {\n // Only write the debug log if logging is enabled\n if ($this->writeDebugLog) {\n $message = sprintf($message, ...$args); //* @phpstan-ignore-line\n $cellReference = implode(' -> ', $this->cellStack->showStack());\n if ($this->echoDebugLog) {\n echo $cellReference,\n ($this->cellStack->count() > 0 ? ' => ' : ''),\n $message,\n PHP_EOL;\n }\n $this->debugLog[] = $cellReference\n . ($this->cellStack->count() > 0 ? ' => ' : '')\n . $message;\n }\n }\n\n /**\n * Write a series of entries to the calculation engine debug log.\n *\n * @param string[] $args\n */\n public function mergeDebugLog(array $args): void\n {\n if ($this->writeDebugLog) {\n foreach ($args as $entry) {\n $this->writeDebugLog($entry);\n }\n }\n }\n\n /**\n * Clear the calculation engine debug log.\n */\n public function clearLog(): void\n {\n $this->debugLog = [];\n }\n\n /**\n * Return the calculation engine debug log.\n *\n * @return string[]\n */\n public function getLog(): array\n {\n return $this->debugLog;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engine/Operands/Operand.php",
"content": "value = $structuredReference;\n }\n\n /** @param string[] $matches */\n public static function fromParser(string $formula, int $index, array $matches): self\n {\n $val = $matches[0];\n\n $srCount = substr_count($val, self::OPEN_BRACE)\n - substr_count($val, self::CLOSE_BRACE);\n while ($srCount > 0) {\n $srIndex = strlen($val);\n $srStringRemainder = substr($formula, $index + $srIndex);\n $closingPos = strpos($srStringRemainder, self::CLOSE_BRACE);\n if ($closingPos === false) {\n throw new Exception(\"Formula Error: No closing ']' to match opening '['\");\n }\n $srStringRemainder = substr($srStringRemainder, 0, $closingPos + 1);\n --$srCount;\n if (str_contains($srStringRemainder, self::OPEN_BRACE)) {\n ++$srCount;\n }\n $val .= $srStringRemainder;\n }\n\n return new self($val);\n }\n\n /**\n * @throws Exception\n * @throws \\PhpOffice\\PhpSpreadsheet\\Exception\n */\n public function parse(Cell $cell): string\n {\n $this->getTableStructure($cell);\n $cellRange = ($this->isRowReference()) ? $this->getRowReference($cell) : $this->getColumnReference();\n $sheetName = '';\n $worksheet = $this->table->getWorksheet();\n if ($worksheet !== null && $worksheet !== $cell->getWorksheet()) {\n $sheetName = \"'\" . $worksheet->getTitle() . \"'!\";\n }\n\n return $sheetName . $cellRange;\n }\n\n private function isRowReference(): bool\n {\n return str_contains($this->value, '[@')\n || str_contains($this->value, '[' . self::ITEM_SPECIFIER_THIS_ROW . ']');\n }\n\n /**\n * @throws Exception\n * @throws \\PhpOffice\\PhpSpreadsheet\\Exception\n */\n private function getTableStructure(Cell $cell): void\n {\n preg_match(self::TABLE_REFERENCE, $this->value, $matches);\n\n $this->tableName = $matches[1];\n $this->table = ($this->tableName === '')\n ? $this->getTableForCell($cell)\n : $this->getTableByName($cell);\n $this->reference = $matches[2];\n $tableRange = Coordinate::getRangeBoundaries($this->table->getRange());\n\n $this->headersRow = ($this->table->getShowHeaderRow()) ? (int) $tableRange[0][1] : null;\n $this->firstDataRow = ($this->table->getShowHeaderRow()) ? (int) $tableRange[0][1] + 1 : $tableRange[0][1];\n $this->totalsRow = ($this->table->getShowTotalsRow()) ? (int) $tableRange[1][1] : null;\n $this->lastDataRow = ($this->table->getShowTotalsRow()) ? (int) $tableRange[1][1] - 1 : $tableRange[1][1];\n\n $cellParam = $cell;\n $worksheet = $this->table->getWorksheet();\n if ($worksheet !== null && $worksheet !== $cell->getWorksheet()) {\n $cellParam = $worksheet->getCell('A1');\n }\n $this->columns = $this->getColumns($cellParam, $tableRange);\n }\n\n /**\n * @throws Exception\n * @throws \\PhpOffice\\PhpSpreadsheet\\Exception\n */\n private function getTableForCell(Cell $cell): Table\n {\n $tables = $cell->getWorksheet()->getTableCollection();\n foreach ($tables as $table) {\n /** @var Table $table */\n $range = $table->getRange();\n if ($cell->isInRange($range) === true) {\n $this->tableName = $table->getName();\n\n return $table;\n }\n }\n\n throw new Exception('Table for Structured Reference cannot be identified');\n }\n\n /**\n * @throws Exception\n * @throws \\PhpOffice\\PhpSpreadsheet\\Exception\n */\n private function getTableByName(Cell $cell): Table\n {\n $table = $cell->getWorksheet()->getTableByName($this->tableName);\n\n if ($table === null) {\n $spreadsheet = $cell->getWorksheet()->getParent();\n if ($spreadsheet !== null) {\n $table = $spreadsheet->getTableByName($this->tableName);\n }\n }\n\n if ($table === null) {\n throw new Exception(\"Table {$this->tableName} for Structured Reference cannot be located\");\n }\n\n return $table;\n }\n\n /**\n * @param array{array{string, int}, array{string, int}} $tableRange\n *\n * @return mixed[]\n */\n private function getColumns(Cell $cell, array $tableRange): array\n {\n $worksheet = $cell->getWorksheet();\n $cellReference = $cell->getCoordinate();\n\n $columns = [];\n $lastColumn = StringHelper::stringIncrement($tableRange[1][0]);\n for ($column = $tableRange[0][0]; $column !== $lastColumn; StringHelper::stringIncrement($column)) {\n /** @var string $column */\n $columns[$column] = $worksheet\n ->getCell($column . ($this->headersRow ?? ($this->firstDataRow - 1)))\n ->getCalculatedValue();\n }\n\n $worksheet->getCell($cellReference);\n\n return $columns;\n }\n\n private function getRowReference(Cell $cell): string\n {\n $reference = str_replace(\"\\u{a0}\", ' ', $this->reference);\n /** @var string $reference */\n $reference = str_replace('[' . self::ITEM_SPECIFIER_THIS_ROW . '],', '', $reference);\n\n foreach ($this->columns as $columnId => $columnName) {\n $columnName = str_replace(\"\\u{a0}\", ' ', $columnName); //* @phpstan-ignore-line\n $reference = $this->adjustRowReference($columnName, $reference, $cell, $columnId);\n }\n\n return $this->validateParsedReference(trim($reference, '[]@, '));\n }\n\n private function adjustRowReference(string $columnName, string $reference, Cell $cell, string $columnId): string\n {\n if ($columnName !== '') {\n $cellReference = $columnId . $cell->getRow();\n $pattern1 = '/\\[' . preg_quote($columnName, '/') . '\\]/miu';\n $pattern2 = '/@' . preg_quote($columnName, '/') . '/miu';\n if (preg_match($pattern1, $reference) === 1) {\n $reference = preg_replace($pattern1, $cellReference, $reference);\n } elseif (preg_match($pattern2, $reference) === 1) {\n $reference = preg_replace($pattern2, $cellReference, $reference);\n }\n /** @var string $reference */\n }\n\n return $reference;\n }\n\n /**\n * @throws Exception\n * @throws \\PhpOffice\\PhpSpreadsheet\\Exception\n */\n private function getColumnReference(): string\n {\n $reference = str_replace(\"\\u{a0}\", ' ', $this->reference);\n $startRow = ($this->totalsRow === null) ? $this->lastDataRow : $this->totalsRow;\n $endRow = ($this->headersRow === null) ? $this->firstDataRow : $this->headersRow;\n\n [$startRow, $endRow] = $this->getRowsForColumnReference($reference, $startRow, $endRow);\n $reference = $this->getColumnsForColumnReference($reference, $startRow, $endRow);\n\n $reference = trim($reference, '[]@, ');\n if (substr_count($reference, ':') > 1) {\n $cells = explode(':', $reference);\n $firstCell = array_shift($cells);\n $lastCell = array_pop($cells);\n $reference = \"{$firstCell}:{$lastCell}\";\n }\n\n return $this->validateParsedReference($reference);\n }\n\n /**\n * @throws Exception\n * @throws \\PhpOffice\\PhpSpreadsheet\\Exception\n */\n private function validateParsedReference(string $reference): string\n {\n if (preg_match('/^' . Calculation::CALCULATION_REGEXP_CELLREF . ':' . Calculation::CALCULATION_REGEXP_CELLREF . '$/miu', $reference) !== 1) {\n if (preg_match('/^' . Calculation::CALCULATION_REGEXP_CELLREF . '$/miu', $reference) !== 1) {\n throw new Exception(\n \"Invalid Structured Reference {$this->reference} {$reference}\",\n Exception::CALCULATION_ENGINE_PUSH_TO_STACK\n );\n }\n }\n\n return $reference;\n }\n\n private function fullData(int $startRow, int $endRow): string\n {\n $columns = array_keys($this->columns);\n $firstColumn = array_shift($columns);\n $lastColumn = (empty($columns)) ? $firstColumn : array_pop($columns);\n\n return \"{$firstColumn}{$startRow}:{$lastColumn}{$endRow}\";\n }\n\n private function getMinimumRow(string $reference): int\n {\n return match ($reference) {\n self::ITEM_SPECIFIER_ALL, self::ITEM_SPECIFIER_HEADERS => $this->headersRow ?? $this->firstDataRow,\n self::ITEM_SPECIFIER_DATA => $this->firstDataRow,\n self::ITEM_SPECIFIER_TOTALS => $this->totalsRow ?? $this->lastDataRow,\n default => $this->headersRow ?? $this->firstDataRow,\n };\n }\n\n private function getMaximumRow(string $reference): int\n {\n return match ($reference) {\n self::ITEM_SPECIFIER_HEADERS => $this->headersRow ?? $this->firstDataRow,\n self::ITEM_SPECIFIER_DATA => $this->lastDataRow,\n self::ITEM_SPECIFIER_ALL, self::ITEM_SPECIFIER_TOTALS => $this->totalsRow ?? $this->lastDataRow,\n default => $this->totalsRow ?? $this->lastDataRow,\n };\n }\n\n public function value(): string\n {\n return $this->value;\n }\n\n /**\n * @return array\n */\n private function getRowsForColumnReference(string &$reference, int $startRow, int $endRow): array\n {\n $rowsSelected = false;\n foreach (self::ITEM_SPECIFIER_ROWS_SET as $rowReference) {\n $pattern = '/\\[' . $rowReference . '\\]/mui';\n if (preg_match($pattern, $reference) === 1) {\n if (($rowReference === self::ITEM_SPECIFIER_HEADERS) && ($this->table->getShowHeaderRow() === false)) {\n throw new Exception(\n 'Table Headers are Hidden, and should not be Referenced',\n Exception::CALCULATION_ENGINE_PUSH_TO_STACK\n );\n }\n $rowsSelected = true;\n $startRow = min($startRow, $this->getMinimumRow($rowReference));\n $endRow = max($endRow, $this->getMaximumRow($rowReference));\n $reference = preg_replace($pattern, '', $reference) ?? '';\n }\n }\n if ($rowsSelected === false) {\n // If there isn't any Special Item Identifier specified, then the selection defaults to data rows only.\n $startRow = $this->firstDataRow;\n $endRow = $this->lastDataRow;\n }\n\n return [$startRow, $endRow];\n }\n\n private function getColumnsForColumnReference(string $reference, int $startRow, int $endRow): string\n {\n $columnsSelected = false;\n foreach ($this->columns as $columnId => $columnName) {\n $columnName = str_replace(\"\\u{a0}\", ' ', $columnName ?? ''); //* @phpstan-ignore-line\n $cellFrom = \"{$columnId}{$startRow}\";\n $cellTo = \"{$columnId}{$endRow}\";\n $cellReference = ($cellFrom === $cellTo) ? $cellFrom : \"{$cellFrom}:{$cellTo}\";\n $pattern = '/\\[' . preg_quote($columnName, '/') . '\\]/mui';\n if (preg_match($pattern, $reference) === 1) {\n $columnsSelected = true;\n $reference = preg_replace($pattern, $cellReference, $reference);\n }\n /** @var string $reference */\n }\n if ($columnsSelected === false) {\n return $this->fullData($startRow, $endRow);\n }\n\n return $reference;\n }\n\n public function __toString(): string\n {\n return $this->value;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engineering/BesselI.php",
"content": "|float|string Result, or a string containing an error\n * If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function BESSELI(mixed $x, mixed $ord): array|string|float\n {\n if (is_array($x) || is_array($ord)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $x, $ord);\n }\n\n try {\n $x = EngineeringValidations::validateFloat($x);\n $ord = EngineeringValidations::validateInt($ord);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n if ($ord < 0) {\n return ExcelError::NAN();\n }\n\n $fResult = self::calculate($x, $ord);\n\n return (is_nan($fResult)) ? ExcelError::NAN() : $fResult;\n }\n\n private static function calculate(float $x, int $ord): float\n {\n return match ($ord) {\n 0 => self::besselI0($x),\n 1 => self::besselI1($x),\n default => self::besselI2($x, $ord),\n };\n }\n\n private static function besselI0(float $x): float\n {\n $ax = abs($x);\n\n if ($ax < 3.75) {\n $y = $x / 3.75;\n $y = $y * $y;\n\n return 1.0 + $y * (3.5156229 + $y * (3.0899424 + $y * (1.2067492\n + $y * (0.2659732 + $y * (0.360768e-1 + $y * 0.45813e-2)))));\n }\n\n $y = 3.75 / $ax;\n\n return (exp($ax) / sqrt($ax)) * (0.39894228 + $y * (0.1328592e-1 + $y * (0.225319e-2 + $y * (-0.157565e-2\n + $y * (0.916281e-2 + $y * (-0.2057706e-1 + $y * (0.2635537e-1\n + $y * (-0.1647633e-1 + $y * 0.392377e-2))))))));\n }\n\n private static function besselI1(float $x): float\n {\n $ax = abs($x);\n\n if ($ax < 3.75) {\n $y = $x / 3.75;\n $y = $y * $y;\n $ans = $ax * (0.5 + $y * (0.87890594 + $y * (0.51498869 + $y * (0.15084934 + $y * (0.2658733e-1\n + $y * (0.301532e-2 + $y * 0.32411e-3))))));\n\n return ($x < 0.0) ? -$ans : $ans;\n }\n\n $y = 3.75 / $ax;\n $ans = 0.2282967e-1 + $y * (-0.2895312e-1 + $y * (0.1787654e-1 - $y * 0.420059e-2));\n $ans = 0.39894228 + $y * (-0.3988024e-1 + $y * (-0.362018e-2 + $y * (0.163801e-2\n + $y * (-0.1031555e-1 + $y * $ans))));\n $ans *= exp($ax) / sqrt($ax);\n\n return ($x < 0.0) ? -$ans : $ans;\n }\n\n private static function besselI2(float $x, int $ord): float\n {\n if ($x === 0.0) {\n return 0.0;\n }\n\n $tox = 2.0 / abs($x);\n $bip = 0;\n $ans = 0.0;\n $bi = 1.0;\n\n for ($j = 2 * ($ord + (int) sqrt(40.0 * $ord)); $j > 0; --$j) {\n $bim = $bip + $j * $tox * $bi;\n $bip = $bi;\n $bi = $bim;\n\n if (abs($bi) > 1.0e+12) {\n $ans *= 1.0e-12;\n $bi *= 1.0e-12;\n $bip *= 1.0e-12;\n }\n\n if ($j === $ord) {\n $ans = $bip;\n }\n }\n\n $ans *= self::besselI0($x) / $bi;\n\n return ($x < 0.0 && (($ord % 2) === 1)) ? -$ans : $ans;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engineering/BesselJ.php",
"content": " 8. This code provides a more accurate calculation\n *\n * @param mixed $x A float value at which to evaluate the function.\n * If x is nonnumeric, BESSELJ returns the #VALUE! error value.\n * Or can be an array of values\n * @param mixed $ord The integer order of the Bessel function.\n * If ord is not an integer, it is truncated.\n * If $ord is nonnumeric, BESSELJ returns the #VALUE! error value.\n * If $ord < 0, BESSELJ returns the #NUM! error value.\n * Or can be an array of values\n *\n * @return array|float|string Result, or a string containing an error\n * If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function BESSELJ(mixed $x, mixed $ord): array|string|float\n {\n if (is_array($x) || is_array($ord)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $x, $ord);\n }\n\n try {\n $x = EngineeringValidations::validateFloat($x);\n $ord = EngineeringValidations::validateInt($ord);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n if ($ord < 0) {\n return ExcelError::NAN();\n }\n\n $fResult = self::calculate($x, $ord);\n\n return (is_nan($fResult)) ? ExcelError::NAN() : $fResult;\n }\n\n private static function calculate(float $x, int $ord): float\n {\n return match ($ord) {\n 0 => self::besselJ0($x),\n 1 => self::besselJ1($x),\n default => self::besselJ2($x, $ord),\n };\n }\n\n private static function besselJ0(float $x): float\n {\n $ax = abs($x);\n\n if ($ax < 8.0) {\n $y = $x * $x;\n $ans1 = 57568490574.0 + $y * (-13362590354.0 + $y * (651619640.7 + $y * (-11214424.18 + $y\n * (77392.33017 + $y * (-184.9052456)))));\n $ans2 = 57568490411.0 + $y * (1029532985.0 + $y * (9494680.718 + $y * (59272.64853 + $y\n * (267.8532712 + $y * 1.0))));\n\n return $ans1 / $ans2;\n }\n\n $z = 8.0 / $ax;\n $y = $z * $z;\n $xx = $ax - 0.785398164;\n $ans1 = 1.0 + $y * (-0.1098628627e-2 + $y * (0.2734510407e-4 + $y * (-0.2073370639e-5 + $y * 0.2093887211e-6)));\n $ans2 = -0.1562499995e-1 + $y * (0.1430488765e-3 + $y * (-0.6911147651e-5 + $y\n * (0.7621095161e-6 - $y * 0.934935152e-7)));\n\n return sqrt(0.636619772 / $ax) * (cos($xx) * $ans1 - $z * sin($xx) * $ans2);\n }\n\n private static function besselJ1(float $x): float\n {\n $ax = abs($x);\n\n if ($ax < 8.0) {\n $y = $x * $x;\n $ans1 = $x * (72362614232.0 + $y * (-7895059235.0 + $y * (242396853.1 + $y\n * (-2972611.439 + $y * (15704.48260 + $y * (-30.16036606))))));\n $ans2 = 144725228442.0 + $y * (2300535178.0 + $y * (18583304.74 + $y * (99447.43394 + $y\n * (376.9991397 + $y * 1.0))));\n\n return $ans1 / $ans2;\n }\n\n $z = 8.0 / $ax;\n $y = $z * $z;\n $xx = $ax - 2.356194491;\n\n $ans1 = 1.0 + $y * (0.183105e-2 + $y * (-0.3516396496e-4 + $y * (0.2457520174e-5 + $y * (-0.240337019e-6))));\n $ans2 = 0.04687499995 + $y * (-0.2002690873e-3 + $y * (0.8449199096e-5 + $y\n * (-0.88228987e-6 + $y * 0.105787412e-6)));\n $ans = sqrt(0.636619772 / $ax) * (cos($xx) * $ans1 - $z * sin($xx) * $ans2);\n\n return ($x < 0.0) ? -$ans : $ans;\n }\n\n private static function besselJ2(float $x, int $ord): float\n {\n $ax = abs($x);\n if ($ax === 0.0) {\n return 0.0;\n }\n\n if ($ax > $ord) {\n return self::besselj2a($ax, $ord, $x);\n }\n\n return self::besselj2b($ax, $ord, $x);\n }\n\n private static function besselj2a(float $ax, int $ord, float $x): float\n {\n $tox = 2.0 / $ax;\n $bjm = self::besselJ0($ax);\n $bj = self::besselJ1($ax);\n for ($j = 1; $j < $ord; ++$j) {\n $bjp = $j * $tox * $bj - $bjm;\n $bjm = $bj;\n $bj = $bjp;\n }\n $ans = $bj;\n\n return ($x < 0.0 && ($ord % 2) == 1) ? -$ans : $ans;\n }\n\n private static function besselj2b(float $ax, int $ord, float $x): float\n {\n $tox = 2.0 / $ax;\n $jsum = false;\n $bjp = $ans = $sum = 0.0;\n $bj = 1.0;\n for ($j = 2 * ($ord + (int) sqrt(40.0 * $ord)); $j > 0; --$j) {\n $bjm = $j * $tox * $bj - $bjp;\n $bjp = $bj;\n $bj = $bjm;\n if (abs($bj) > 1.0e+10) {\n $bj *= 1.0e-10;\n $bjp *= 1.0e-10;\n $ans *= 1.0e-10;\n $sum *= 1.0e-10;\n }\n if ($jsum === true) {\n $sum += $bj;\n }\n $jsum = $jsum === false;\n if ($j === $ord) {\n $ans = $bjp;\n }\n }\n $sum = 2.0 * $sum - $bj;\n $ans /= $sum;\n\n return ($x < 0.0 && ($ord % 2) === 1) ? -$ans : $ans;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engineering/BesselK.php",
"content": "|float|string Result, or a string containing an error\n * If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function BESSELK(mixed $x, mixed $ord): array|string|float\n {\n if (is_array($x) || is_array($ord)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $x, $ord);\n }\n\n try {\n $x = EngineeringValidations::validateFloat($x);\n $ord = EngineeringValidations::validateInt($ord);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n if (($ord < 0) || ($x <= 0.0)) {\n return ExcelError::NAN();\n }\n\n $fBk = self::calculate($x, $ord);\n\n return (is_nan($fBk)) ? ExcelError::NAN() : $fBk;\n }\n\n private static function calculate(float $x, int $ord): float\n {\n return match ($ord) {\n 0 => self::besselK0($x),\n 1 => self::besselK1($x),\n default => self::besselK2($x, $ord),\n };\n }\n\n /**\n * Mollify Phpstan.\n *\n * @codeCoverageIgnore\n */\n private static function callBesselI(float $x, int $ord): float\n {\n $rslt = BesselI::BESSELI($x, $ord);\n if (!is_float($rslt)) {\n throw new Exception('Unexpected array or string');\n }\n\n return $rslt;\n }\n\n private static function besselK0(float $x): float\n {\n if ($x <= 2) {\n $fNum2 = $x * 0.5;\n $y = ($fNum2 * $fNum2);\n\n return -log($fNum2) * self::callBesselI($x, 0)\n + (-0.57721566 + $y * (0.42278420 + $y * (0.23069756 + $y * (0.3488590e-1 + $y * (0.262698e-2 + $y\n * (0.10750e-3 + $y * 0.74e-5))))));\n }\n\n $y = 2 / $x;\n\n return exp(-$x) / sqrt($x)\n * (1.25331414 + $y * (-0.7832358e-1 + $y * (0.2189568e-1 + $y * (-0.1062446e-1 + $y\n * (0.587872e-2 + $y * (-0.251540e-2 + $y * 0.53208e-3))))));\n }\n\n private static function besselK1(float $x): float\n {\n if ($x <= 2) {\n $fNum2 = $x * 0.5;\n $y = ($fNum2 * $fNum2);\n\n return log($fNum2) * self::callBesselI($x, 1)\n + (1 + $y * (0.15443144 + $y * (-0.67278579 + $y * (-0.18156897 + $y * (-0.1919402e-1 + $y\n * (-0.110404e-2 + $y * (-0.4686e-4))))))) / $x;\n }\n\n $y = 2 / $x;\n\n return exp(-$x) / sqrt($x)\n * (1.25331414 + $y * (0.23498619 + $y * (-0.3655620e-1 + $y * (0.1504268e-1 + $y * (-0.780353e-2 + $y\n * (0.325614e-2 + $y * (-0.68245e-3)))))));\n }\n\n private static function besselK2(float $x, int $ord): float\n {\n $fTox = 2 / $x;\n $fBkm = self::besselK0($x);\n $fBk = self::besselK1($x);\n for ($n = 1; $n < $ord; ++$n) {\n $fBkp = $fBkm + $n * $fTox * $fBk;\n $fBkm = $fBk;\n $fBk = $fBkp;\n }\n\n return $fBk;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engineering/BesselY.php",
"content": "|float|string Result, or a string containing an error\n * If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function BESSELY(mixed $x, mixed $ord): array|string|float\n {\n if (is_array($x) || is_array($ord)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $x, $ord);\n }\n\n try {\n $x = EngineeringValidations::validateFloat($x);\n $ord = EngineeringValidations::validateInt($ord);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n if (($ord < 0) || ($x <= 0.0)) {\n return ExcelError::NAN();\n }\n\n $fBy = self::calculate($x, $ord);\n\n return (is_nan($fBy)) ? ExcelError::NAN() : $fBy;\n }\n\n private static function calculate(float $x, int $ord): float\n {\n return match ($ord) {\n 0 => self::besselY0($x),\n 1 => self::besselY1($x),\n default => self::besselY2($x, $ord),\n };\n }\n\n /**\n * Mollify Phpstan.\n *\n * @codeCoverageIgnore\n */\n private static function callBesselJ(float $x, int $ord): float\n {\n $rslt = BesselJ::BESSELJ($x, $ord);\n if (!is_float($rslt)) {\n throw new Exception('Unexpected array or string');\n }\n\n return $rslt;\n }\n\n private static function besselY0(float $x): float\n {\n if ($x < 8.0) {\n $y = ($x * $x);\n $ans1 = -2957821389.0 + $y * (7062834065.0 + $y * (-512359803.6 + $y * (10879881.29 + $y\n * (-86327.92757 + $y * 228.4622733))));\n $ans2 = 40076544269.0 + $y * (745249964.8 + $y * (7189466.438 + $y\n * (47447.26470 + $y * (226.1030244 + $y))));\n\n return $ans1 / $ans2 + 0.636619772 * self::callBesselJ($x, 0) * log($x);\n }\n\n $z = 8.0 / $x;\n $y = ($z * $z);\n $xx = $x - 0.785398164;\n $ans1 = 1 + $y * (-0.1098628627e-2 + $y * (0.2734510407e-4 + $y * (-0.2073370639e-5 + $y * 0.2093887211e-6)));\n $ans2 = -0.1562499995e-1 + $y * (0.1430488765e-3 + $y * (-0.6911147651e-5 + $y * (0.7621095161e-6 + $y\n * (-0.934945152e-7))));\n\n return sqrt(0.636619772 / $x) * (sin($xx) * $ans1 + $z * cos($xx) * $ans2);\n }\n\n private static function besselY1(float $x): float\n {\n if ($x < 8.0) {\n $y = ($x * $x);\n $ans1 = $x * (-0.4900604943e13 + $y * (0.1275274390e13 + $y * (-0.5153438139e11 + $y\n * (0.7349264551e9 + $y * (-0.4237922726e7 + $y * 0.8511937935e4)))));\n $ans2 = 0.2499580570e14 + $y * (0.4244419664e12 + $y * (0.3733650367e10 + $y * (0.2245904002e8 + $y\n * (0.1020426050e6 + $y * (0.3549632885e3 + $y)))));\n\n return ($ans1 / $ans2) + 0.636619772 * (self::callBesselJ($x, 1) * log($x) - 1 / $x);\n }\n\n $z = 8.0 / $x;\n $y = $z * $z;\n $xx = $x - 2.356194491;\n $ans1 = 1.0 + $y * (0.183105e-2 + $y * (-0.3516396496e-4 + $y * (0.2457520174e-5 + $y * (-0.240337019e-6))));\n $ans2 = 0.04687499995 + $y * (-0.2002690873e-3 + $y * (0.8449199096e-5 + $y\n * (-0.88228987e-6 + $y * 0.105787412e-6)));\n\n return sqrt(0.636619772 / $x) * (sin($xx) * $ans1 + $z * cos($xx) * $ans2);\n }\n\n private static function besselY2(float $x, int $ord): float\n {\n $fTox = 2.0 / $x;\n $fBym = self::besselY0($x);\n $fBy = self::besselY1($x);\n for ($n = 1; $n < $ord; ++$n) {\n $fByp = $n * $fTox * $fBy - $fBym;\n $fBym = $fBy;\n $fBy = $fByp;\n }\n\n return $fBy;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engineering/BitWise.php",
"content": "|bool|float|int|string $number1 Or can be an array of values\n * @param null|array|bool|float|int|string $number2 Or can be an array of values\n *\n * @return array|int|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function BITAND(null|array|bool|float|int|string $number1, null|array|bool|float|int|string $number2): array|string|int|float\n {\n if (is_array($number1) || is_array($number2)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $number1, $number2);\n }\n\n try {\n $number1 = self::validateBitwiseArgument($number1);\n $number2 = self::validateBitwiseArgument($number2);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n $split1 = self::splitNumber($number1);\n $split2 = self::splitNumber($number2);\n\n return self::SPLIT_DIVISOR * ($split1[0] & $split2[0]) + ($split1[1] & $split2[1]);\n }\n\n /**\n * BITOR.\n *\n * Returns the bitwise OR of two integer values.\n *\n * Excel Function:\n * BITOR(number1, number2)\n *\n * @param null|array|bool|float|int|string $number1 Or can be an array of values\n * @param null|array|bool|float|int|string $number2 Or can be an array of values\n *\n * @return array|int|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function BITOR(null|array|bool|float|int|string $number1, null|array|bool|float|int|string $number2): array|string|int|float\n {\n if (is_array($number1) || is_array($number2)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $number1, $number2);\n }\n\n try {\n $number1 = self::validateBitwiseArgument($number1);\n $number2 = self::validateBitwiseArgument($number2);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n $split1 = self::splitNumber($number1);\n $split2 = self::splitNumber($number2);\n\n return self::SPLIT_DIVISOR * ($split1[0] | $split2[0]) + ($split1[1] | $split2[1]);\n }\n\n /**\n * BITXOR.\n *\n * Returns the bitwise XOR of two integer values.\n *\n * Excel Function:\n * BITXOR(number1, number2)\n *\n * @param null|array|bool|float|int|string $number1 Or can be an array of values\n * @param null|array|bool|float|int|string $number2 Or can be an array of values\n *\n * @return array|int|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function BITXOR(null|array|bool|float|int|string $number1, null|array|bool|float|int|string $number2): array|string|int|float\n {\n if (is_array($number1) || is_array($number2)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $number1, $number2);\n }\n\n try {\n $number1 = self::validateBitwiseArgument($number1);\n $number2 = self::validateBitwiseArgument($number2);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n $split1 = self::splitNumber($number1);\n $split2 = self::splitNumber($number2);\n\n return self::SPLIT_DIVISOR * ($split1[0] ^ $split2[0]) + ($split1[1] ^ $split2[1]);\n }\n\n /**\n * BITLSHIFT.\n *\n * Returns the number value shifted left by shift_amount bits.\n *\n * Excel Function:\n * BITLSHIFT(number, shift_amount)\n *\n * @param null|array|bool|float|int|string $number Or can be an array of values\n * @param null|array|bool|float|int|string $shiftAmount Or can be an array of values\n *\n * @return array|float|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function BITLSHIFT(null|array|bool|float|int|string $number, null|array|bool|float|int|string $shiftAmount): array|string|float\n {\n if (is_array($number) || is_array($shiftAmount)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $number, $shiftAmount);\n }\n\n try {\n $number = self::validateBitwiseArgument($number);\n $shiftAmount = self::validateShiftAmount($shiftAmount);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n $result = floor($number * (2 ** $shiftAmount));\n if ($result > 2 ** 48 - 1) {\n return ExcelError::NAN();\n }\n\n return $result;\n }\n\n /**\n * BITRSHIFT.\n *\n * Returns the number value shifted right by shift_amount bits.\n *\n * Excel Function:\n * BITRSHIFT(number, shift_amount)\n *\n * @param null|array|bool|float|int|string $number Or can be an array of values\n * @param null|array|bool|float|int|string $shiftAmount Or can be an array of values\n *\n * @return array|float|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function BITRSHIFT(null|array|bool|float|int|string $number, null|array|bool|float|int|string $shiftAmount): array|string|float\n {\n if (is_array($number) || is_array($shiftAmount)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $number, $shiftAmount);\n }\n\n try {\n $number = self::validateBitwiseArgument($number);\n $shiftAmount = self::validateShiftAmount($shiftAmount);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n $result = floor($number / (2 ** $shiftAmount));\n if ($result > 2 ** 48 - 1) { // possible because shiftAmount can be negative\n return ExcelError::NAN();\n }\n\n return $result;\n }\n\n /**\n * Validate arguments passed to the bitwise functions.\n */\n private static function validateBitwiseArgument(mixed $value): float\n {\n $value = self::nullFalseTrueToNumber($value);\n\n if (is_numeric($value)) {\n $value = (float) $value;\n if ($value == floor($value)) {\n if (($value > 2 ** 48 - 1) || ($value < 0)) {\n throw new Exception(ExcelError::NAN());\n }\n\n return floor($value);\n }\n\n throw new Exception(ExcelError::NAN());\n }\n\n throw new Exception(ExcelError::VALUE());\n }\n\n /**\n * Validate arguments passed to the bitwise functions.\n */\n private static function validateShiftAmount(mixed $value): int\n {\n $value = self::nullFalseTrueToNumber($value);\n\n if (is_numeric($value)) {\n if (abs($value + 0) > 53) {\n throw new Exception(ExcelError::NAN());\n }\n\n return (int) $value;\n }\n\n throw new Exception(ExcelError::VALUE());\n }\n\n /**\n * Many functions accept null/false/true argument treated as 0/0/1.\n */\n private static function nullFalseTrueToNumber(mixed &$number): mixed\n {\n if ($number === null) {\n $number = 0;\n } elseif (is_bool($number)) {\n $number = (int) $number;\n }\n\n return $number;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engineering/Compare.php",
"content": "|bool|float|int|string $a the first number\n * Or can be an array of values\n * @param array|bool|float|int|string $b The second number. If omitted, b is assumed to be zero.\n * Or can be an array of values\n *\n * @return array|int|string (string in the event of an error)\n * If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function DELTA(array|float|bool|string|int $a, array|float|bool|string|int $b = 0.0): array|string|int\n {\n if (is_array($a) || is_array($b)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $a, $b);\n }\n\n try {\n $a = EngineeringValidations::validateFloat($a);\n $b = EngineeringValidations::validateFloat($b);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n return (int) (abs($a - $b) < 1.0e-15);\n }\n\n /**\n * GESTEP.\n *\n * Excel Function:\n * GESTEP(number[,step])\n *\n * Returns 1 if number >= step; returns 0 (zero) otherwise\n * Use this function to filter a set of values. For example, by summing several GESTEP\n * functions you calculate the count of values that exceed a threshold.\n *\n * @param array|bool|float|int|string $number the value to test against step\n * Or can be an array of values\n * @param null|array|bool|float|int|string $step The threshold value. If you omit a value for step, GESTEP uses zero.\n * Or can be an array of values\n *\n * @return array|int|string (string in the event of an error)\n * If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function GESTEP(array|float|bool|string|int $number, $step = 0.0): array|string|int\n {\n if (is_array($number) || is_array($step)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $number, $step);\n }\n\n try {\n $number = EngineeringValidations::validateFloat($number);\n $step = EngineeringValidations::validateFloat($step ?? 0.0);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n return (int) ($number >= $step);\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engineering/Complex.php",
"content": "|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function COMPLEX(mixed $realNumber = 0.0, mixed $imaginary = 0.0, mixed $suffix = 'i'): array|string\n {\n if (is_array($realNumber) || is_array($imaginary) || is_array($suffix)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $realNumber, $imaginary, $suffix);\n }\n\n $realNumber = $realNumber ?? 0.0;\n $imaginary = $imaginary ?? 0.0;\n $suffix = $suffix ?? 'i';\n\n try {\n $realNumber = EngineeringValidations::validateFloat($realNumber);\n $imaginary = EngineeringValidations::validateFloat($imaginary);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n if (($suffix === 'i') || ($suffix === 'j') || ($suffix === '')) {\n $complex = new ComplexObject($realNumber, $imaginary, $suffix);\n\n return (string) $complex;\n }\n\n return ExcelError::VALUE();\n }\n\n /**\n * IMAGINARY.\n *\n * Returns the imaginary coefficient of a complex number in x + yi or x + yj text format.\n *\n * Excel Function:\n * IMAGINARY(complexNumber)\n *\n * @param array|string $complexNumber the complex number for which you want the imaginary\n * coefficient\n * Or can be an array of values\n *\n * @return array|float|string (string if an error)\n * If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function IMAGINARY($complexNumber): array|string|float\n {\n if (is_array($complexNumber)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);\n }\n\n try {\n $complex = new ComplexObject($complexNumber);\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n\n return $complex->getImaginary();\n }\n\n /**\n * IMREAL.\n *\n * Returns the real coefficient of a complex number in x + yi or x + yj text format.\n *\n * Excel Function:\n * IMREAL(complexNumber)\n *\n * @param array|string $complexNumber the complex number for which you want the real coefficient\n * Or can be an array of values\n *\n * @return array|float|string (string if an error)\n * If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function IMREAL($complexNumber): array|string|float\n {\n if (is_array($complexNumber)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);\n }\n\n try {\n $complex = new ComplexObject($complexNumber);\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n\n return $complex->getReal();\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engineering/ComplexFunctions.php",
"content": "|string $complexNumber the complex number for which you want the absolute value\n * Or can be an array of values\n *\n * @return array|float|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function IMABS(array|string $complexNumber): array|float|string\n {\n if (is_array($complexNumber)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);\n }\n\n try {\n $complex = new ComplexObject($complexNumber);\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n\n return $complex->abs();\n }\n\n /**\n * IMARGUMENT.\n *\n * Returns the argument theta of a complex number, i.e. the angle in radians from the real\n * axis to the representation of the number in polar coordinates.\n *\n * Excel Function:\n * IMARGUMENT(complexNumber)\n *\n * @param array|string $complexNumber the complex number for which you want the argument theta\n * Or can be an array of values\n *\n * @return array|float|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function IMARGUMENT(array|string $complexNumber): array|float|string\n {\n if (is_array($complexNumber)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);\n }\n\n try {\n $complex = new ComplexObject($complexNumber);\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n\n if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {\n return ExcelError::DIV0();\n }\n\n return $complex->argument();\n }\n\n /**\n * IMCONJUGATE.\n *\n * Returns the complex conjugate of a complex number in x + yi or x + yj text format.\n *\n * Excel Function:\n * IMCONJUGATE(complexNumber)\n *\n * @param array|string $complexNumber the complex number for which you want the conjugate\n * Or can be an array of values\n *\n * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function IMCONJUGATE(array|string $complexNumber): array|string\n {\n if (is_array($complexNumber)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);\n }\n\n try {\n $complex = new ComplexObject($complexNumber);\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n\n return (string) $complex->conjugate();\n }\n\n /**\n * IMCOS.\n *\n * Returns the cosine of a complex number in x + yi or x + yj text format.\n *\n * Excel Function:\n * IMCOS(complexNumber)\n *\n * @param array|string $complexNumber the complex number for which you want the cosine\n * Or can be an array of values\n *\n * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function IMCOS(array|string $complexNumber): array|string\n {\n if (is_array($complexNumber)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);\n }\n\n try {\n $complex = new ComplexObject($complexNumber);\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n\n return (string) $complex->cos();\n }\n\n /**\n * IMCOSH.\n *\n * Returns the hyperbolic cosine of a complex number in x + yi or x + yj text format.\n *\n * Excel Function:\n * IMCOSH(complexNumber)\n *\n * @param array|string $complexNumber the complex number for which you want the hyperbolic cosine\n * Or can be an array of values\n *\n * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function IMCOSH(array|string $complexNumber): array|string\n {\n if (is_array($complexNumber)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);\n }\n\n try {\n $complex = new ComplexObject($complexNumber);\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n\n return (string) $complex->cosh();\n }\n\n /**\n * IMCOT.\n *\n * Returns the cotangent of a complex number in x + yi or x + yj text format.\n *\n * Excel Function:\n * IMCOT(complexNumber)\n *\n * @param array|string $complexNumber the complex number for which you want the cotangent\n * Or can be an array of values\n *\n * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function IMCOT(array|string $complexNumber): array|string\n {\n if (is_array($complexNumber)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);\n }\n\n try {\n $complex = new ComplexObject($complexNumber);\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n\n return (string) $complex->cot();\n }\n\n /**\n * IMCSC.\n *\n * Returns the cosecant of a complex number in x + yi or x + yj text format.\n *\n * Excel Function:\n * IMCSC(complexNumber)\n *\n * @param array|string $complexNumber the complex number for which you want the cosecant\n * Or can be an array of values\n *\n * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function IMCSC(array|string $complexNumber): array|string\n {\n if (is_array($complexNumber)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);\n }\n\n try {\n $complex = new ComplexObject($complexNumber);\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n\n return (string) $complex->csc();\n }\n\n /**\n * IMCSCH.\n *\n * Returns the hyperbolic cosecant of a complex number in x + yi or x + yj text format.\n *\n * Excel Function:\n * IMCSCH(complexNumber)\n *\n * @param array|string $complexNumber the complex number for which you want the hyperbolic cosecant\n * Or can be an array of values\n *\n * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function IMCSCH(array|string $complexNumber): array|string\n {\n if (is_array($complexNumber)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);\n }\n\n try {\n $complex = new ComplexObject($complexNumber);\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n\n return (string) $complex->csch();\n }\n\n /**\n * IMSIN.\n *\n * Returns the sine of a complex number in x + yi or x + yj text format.\n *\n * Excel Function:\n * IMSIN(complexNumber)\n *\n * @param array|string $complexNumber the complex number for which you want the sine\n * Or can be an array of values\n *\n * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function IMSIN(array|string $complexNumber): array|string\n {\n if (is_array($complexNumber)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);\n }\n\n try {\n $complex = new ComplexObject($complexNumber);\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n\n return (string) $complex->sin();\n }\n\n /**\n * IMSINH.\n *\n * Returns the hyperbolic sine of a complex number in x + yi or x + yj text format.\n *\n * Excel Function:\n * IMSINH(complexNumber)\n *\n * @param array|string $complexNumber the complex number for which you want the hyperbolic sine\n * Or can be an array of values\n *\n * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function IMSINH(array|string $complexNumber): array|string\n {\n if (is_array($complexNumber)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);\n }\n\n try {\n $complex = new ComplexObject($complexNumber);\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n\n return (string) $complex->sinh();\n }\n\n /**\n * IMSEC.\n *\n * Returns the secant of a complex number in x + yi or x + yj text format.\n *\n * Excel Function:\n * IMSEC(complexNumber)\n *\n * @param array|string $complexNumber the complex number for which you want the secant\n * Or can be an array of values\n *\n * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function IMSEC(array|string $complexNumber): array|string\n {\n if (is_array($complexNumber)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);\n }\n\n try {\n $complex = new ComplexObject($complexNumber);\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n\n return (string) $complex->sec();\n }\n\n /**\n * IMSECH.\n *\n * Returns the hyperbolic secant of a complex number in x + yi or x + yj text format.\n *\n * Excel Function:\n * IMSECH(complexNumber)\n *\n * @param array|string $complexNumber the complex number for which you want the hyperbolic secant\n * Or can be an array of values\n *\n * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function IMSECH(array|string $complexNumber): array|string\n {\n if (is_array($complexNumber)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);\n }\n\n try {\n $complex = new ComplexObject($complexNumber);\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n\n return (string) $complex->sech();\n }\n\n /**\n * IMTAN.\n *\n * Returns the tangent of a complex number in x + yi or x + yj text format.\n *\n * Excel Function:\n * IMTAN(complexNumber)\n *\n * @param array|string $complexNumber the complex number for which you want the tangent\n * Or can be an array of values\n *\n * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function IMTAN(array|string $complexNumber): array|string\n {\n if (is_array($complexNumber)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);\n }\n\n try {\n $complex = new ComplexObject($complexNumber);\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n\n return (string) $complex->tan();\n }\n\n /**\n * IMSQRT.\n *\n * Returns the square root of a complex number in x + yi or x + yj text format.\n *\n * Excel Function:\n * IMSQRT(complexNumber)\n *\n * @param array|string $complexNumber the complex number for which you want the square root\n * Or can be an array of values\n *\n * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function IMSQRT(array|string $complexNumber): array|string\n {\n if (is_array($complexNumber)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);\n }\n\n try {\n $complex = new ComplexObject($complexNumber);\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n\n $theta = self::IMARGUMENT($complexNumber);\n if ($theta === ExcelError::DIV0()) {\n return '0';\n }\n\n return (string) $complex->sqrt();\n }\n\n /**\n * IMLN.\n *\n * Returns the natural logarithm of a complex number in x + yi or x + yj text format.\n *\n * Excel Function:\n * IMLN(complexNumber)\n *\n * @param array|string $complexNumber the complex number for which you want the natural logarithm\n * Or can be an array of values\n *\n * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function IMLN(array|string $complexNumber): array|string\n {\n if (is_array($complexNumber)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);\n }\n\n try {\n $complex = new ComplexObject($complexNumber);\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n\n if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {\n return ExcelError::NAN();\n }\n\n return (string) $complex->ln();\n }\n\n /**\n * IMLOG10.\n *\n * Returns the common logarithm (base 10) of a complex number in x + yi or x + yj text format.\n *\n * Excel Function:\n * IMLOG10(complexNumber)\n *\n * @param array|string $complexNumber the complex number for which you want the common logarithm\n * Or can be an array of values\n *\n * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function IMLOG10(array|string $complexNumber): array|string\n {\n if (is_array($complexNumber)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);\n }\n\n try {\n $complex = new ComplexObject($complexNumber);\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n\n if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {\n return ExcelError::NAN();\n }\n\n return (string) $complex->log10();\n }\n\n /**\n * IMLOG2.\n *\n * Returns the base-2 logarithm of a complex number in x + yi or x + yj text format.\n *\n * Excel Function:\n * IMLOG2(complexNumber)\n *\n * @param array|string $complexNumber the complex number for which you want the base-2 logarithm\n * Or can be an array of values\n *\n * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function IMLOG2(array|string $complexNumber): array|string\n {\n if (is_array($complexNumber)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);\n }\n\n try {\n $complex = new ComplexObject($complexNumber);\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n\n if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {\n return ExcelError::NAN();\n }\n\n return (string) $complex->log2();\n }\n\n /**\n * IMEXP.\n *\n * Returns the exponential of a complex number in x + yi or x + yj text format.\n *\n * Excel Function:\n * IMEXP(complexNumber)\n *\n * @param array|string $complexNumber the complex number for which you want the exponential\n * Or can be an array of values\n *\n * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function IMEXP(array|string $complexNumber): array|string\n {\n if (is_array($complexNumber)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);\n }\n\n try {\n $complex = new ComplexObject($complexNumber);\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n\n return (string) $complex->exp();\n }\n\n /**\n * IMPOWER.\n *\n * Returns a complex number in x + yi or x + yj text format raised to a power.\n *\n * Excel Function:\n * IMPOWER(complexNumber,realNumber)\n *\n * @param array|string $complexNumber the complex number you want to raise to a power\n * Or can be an array of values\n * @param array|float|int|string $realNumber the power to which you want to raise the complex number\n * Or can be an array of values\n *\n * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function IMPOWER(array|string $complexNumber, array|float|int|string $realNumber): array|string\n {\n if (is_array($complexNumber) || is_array($realNumber)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $complexNumber, $realNumber);\n }\n\n try {\n $complex = new ComplexObject($complexNumber);\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n\n if (!is_numeric($realNumber)) {\n return ExcelError::VALUE();\n }\n\n return (string) $complex->pow((float) $realNumber);\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engineering/ComplexOperations.php",
"content": "|string $complexDividend the complex numerator or dividend\n * Or can be an array of values\n * @param array|string $complexDivisor the complex denominator or divisor\n * Or can be an array of values\n *\n * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function IMDIV(array|string $complexDividend, array|string $complexDivisor): array|string\n {\n if (is_array($complexDividend) || is_array($complexDivisor)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $complexDividend, $complexDivisor);\n }\n\n try {\n return (string) (new ComplexObject($complexDividend))->divideby(new ComplexObject($complexDivisor));\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n }\n\n /**\n * IMSUB.\n *\n * Returns the difference of two complex numbers in x + yi or x + yj text format.\n *\n * Excel Function:\n * IMSUB(complexNumber1,complexNumber2)\n *\n * @param array|string $complexNumber1 the complex number from which to subtract complexNumber2\n * Or can be an array of values\n * @param array|string $complexNumber2 the complex number to subtract from complexNumber1\n * Or can be an array of values\n *\n * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function IMSUB(array|string $complexNumber1, array|string $complexNumber2): array|string\n {\n if (is_array($complexNumber1) || is_array($complexNumber2)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $complexNumber1, $complexNumber2);\n }\n\n try {\n return (string) (new ComplexObject($complexNumber1))->subtract(new ComplexObject($complexNumber2));\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n }\n\n /**\n * IMSUM.\n *\n * Returns the sum of two or more complex numbers in x + yi or x + yj text format.\n *\n * Excel Function:\n * IMSUM(complexNumber[,complexNumber[,...]])\n *\n * @param string ...$complexNumbers Series of complex numbers to add\n */\n public static function IMSUM(...$complexNumbers): string\n {\n // Return value\n $returnValue = new ComplexObject(0.0);\n $aArgs = Functions::flattenArray($complexNumbers);\n\n try {\n // Loop through the arguments\n foreach ($aArgs as $complex) {\n $returnValue = $returnValue->add(new ComplexObject($complex));\n }\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n\n return (string) $returnValue;\n }\n\n /**\n * IMPRODUCT.\n *\n * Returns the product of two or more complex numbers in x + yi or x + yj text format.\n *\n * Excel Function:\n * IMPRODUCT(complexNumber[,complexNumber[,...]])\n *\n * @param string ...$complexNumbers Series of complex numbers to multiply\n */\n public static function IMPRODUCT(...$complexNumbers): string\n {\n // Return value\n $returnValue = new ComplexObject(1.0);\n $aArgs = Functions::flattenArray($complexNumbers);\n\n try {\n // Loop through the arguments\n foreach ($aArgs as $complex) {\n $returnValue = $returnValue->multiply(new ComplexObject($complex));\n }\n } catch (ComplexException) {\n return ExcelError::NAN();\n }\n\n return (string) $returnValue;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engineering/Constants.php",
"content": " 10) {\n throw new Exception(ExcelError::NAN());\n }\n\n return (int) $places;\n }\n\n throw new Exception(ExcelError::VALUE());\n }\n\n /**\n * Formats a number base string value with leading zeroes.\n *\n * @param string $value The \"number\" to pad\n * @param ?int $places The length that we want to pad this value\n *\n * @return string The padded \"number\"\n */\n protected static function nbrConversionFormat(string $value, ?int $places): string\n {\n if ($places !== null) {\n if (strlen($value) <= $places) {\n return substr(str_pad($value, $places, '0', STR_PAD_LEFT), -10);\n }\n\n return ExcelError::NAN();\n }\n\n return substr($value, -10);\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engineering/ConvertBinary.php",
"content": "|bool|float|int|string $value The binary number (as a string) that you want to convert. The number\n * cannot contain more than 10 characters (10 bits). The most significant\n * bit of number is the sign bit. The remaining 9 bits are magnitude bits.\n * Negative numbers are represented using two's-complement notation.\n * If number is not a valid binary number, or if number contains more than\n * 10 characters (10 bits), BIN2DEC returns the #NUM! error value.\n * Or can be an array of values\n *\n * @return array|float|int|string Result, or an error\n * If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function toDecimal($value)\n {\n if (is_array($value)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $value);\n }\n\n try {\n $value = self::validateValue($value);\n $value = self::validateBinary($value);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n if (strlen($value) == 10 && $value[0] === '1') {\n // Two's Complement\n $value = substr($value, -9);\n\n return -(512 - bindec($value));\n }\n\n return bindec($value);\n }\n\n /**\n * toHex.\n *\n * Return a binary value as hex.\n *\n * Excel Function:\n * BIN2HEX(x[,places])\n *\n * @param array|bool|float|int|string $value The binary number (as a string) that you want to convert. The number\n * cannot contain more than 10 characters (10 bits). The most significant\n * bit of number is the sign bit. The remaining 9 bits are magnitude bits.\n * Negative numbers are represented using two's-complement notation.\n * If number is not a valid binary number, or if number contains more than\n * 10 characters (10 bits), BIN2HEX returns the #NUM! error value.\n * Or can be an array of values\n * @param null|array|float|int|string $places The number of characters to use. If places is omitted, BIN2HEX uses the\n * minimum number of characters necessary. Places is useful for padding the\n * return value with leading 0s (zeros).\n * If places is not an integer, it is truncated.\n * If places is nonnumeric, BIN2HEX returns the #VALUE! error value.\n * If places is negative, BIN2HEX returns the #NUM! error value.\n * Or can be an array of values\n *\n * @return array|string Result, or an error\n * If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function toHex($value, $places = null): array|string\n {\n if (is_array($value) || is_array($places)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $places);\n }\n\n try {\n $value = self::validateValue($value);\n $value = self::validateBinary($value);\n $places = self::validatePlaces($places);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n if (strlen($value) == 10 && $value[0] === '1') {\n $high2 = substr($value, 0, 2);\n $low8 = substr($value, 2);\n $xarr = ['00' => '00000000', '01' => '00000001', '10' => 'FFFFFFFE', '11' => 'FFFFFFFF'];\n\n return $xarr[$high2] . strtoupper(substr('0' . dechex((int) bindec($low8)), -2));\n }\n $hexVal = (string) strtoupper(dechex((int) bindec($value)));\n\n return self::nbrConversionFormat($hexVal, $places);\n }\n\n /**\n * toOctal.\n *\n * Return a binary value as octal.\n *\n * Excel Function:\n * BIN2OCT(x[,places])\n *\n * @param array|bool|float|int|string $value The binary number (as a string) that you want to convert. The number\n * cannot contain more than 10 characters (10 bits). The most significant\n * bit of number is the sign bit. The remaining 9 bits are magnitude bits.\n * Negative numbers are represented using two's-complement notation.\n * If number is not a valid binary number, or if number contains more than\n * 10 characters (10 bits), BIN2OCT returns the #NUM! error value.\n * Or can be an array of values\n * @param null|array|float|int|string $places The number of characters to use. If places is omitted, BIN2OCT uses the\n * minimum number of characters necessary. Places is useful for padding the\n * return value with leading 0s (zeros).\n * If places is not an integer, it is truncated.\n * If places is nonnumeric, BIN2OCT returns the #VALUE! error value.\n * If places is negative, BIN2OCT returns the #NUM! error value.\n * Or can be an array of values\n *\n * @return array|string Result, or an error\n * If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function toOctal($value, $places = null): array|string\n {\n if (is_array($value) || is_array($places)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $places);\n }\n\n try {\n $value = self::validateValue($value);\n $value = self::validateBinary($value);\n $places = self::validatePlaces($places);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n if (strlen($value) == 10 && $value[0] === '1') { // Two's Complement\n return str_repeat('7', 6) . strtoupper(decoct((int) bindec(\"11$value\")));\n }\n $octVal = (string) decoct((int) bindec($value));\n\n return self::nbrConversionFormat($octVal, $places);\n }\n\n protected static function validateBinary(string $value): string\n {\n if ((strlen($value) > preg_match_all('/[01]/', $value)) || (strlen($value) > 10)) {\n throw new Exception(ExcelError::NAN());\n }\n\n return $value;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engineering/ConvertDecimal.php",
"content": "|bool|float|int|string $value The decimal integer you want to convert. If number is negative,\n * valid place values are ignored and DEC2BIN returns a 10-character\n * (10-bit) binary number in which the most significant bit is the sign\n * bit. The remaining 9 bits are magnitude bits. Negative numbers are\n * represented using two's-complement notation.\n * If number < -512 or if number > 511, DEC2BIN returns the #NUM! error\n * value.\n * If number is nonnumeric, DEC2BIN returns the #VALUE! error value.\n * If DEC2BIN requires more than places characters, it returns the #NUM!\n * error value.\n * Or can be an array of values\n * @param null|array|float|int|string $places The number of characters to use. If places is omitted, DEC2BIN uses\n * the minimum number of characters necessary. Places is useful for\n * padding the return value with leading 0s (zeros).\n * If places is not an integer, it is truncated.\n * If places is nonnumeric, DEC2BIN returns the #VALUE! error value.\n * If places is zero or negative, DEC2BIN returns the #NUM! error value.\n * Or can be an array of values\n *\n * @return array|string Result, or an error\n * If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function toBinary($value, $places = null): array|string\n {\n if (is_array($value) || is_array($places)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $places);\n }\n\n try {\n $value = self::validateValue($value);\n $value = self::validateDecimal($value);\n $places = self::validatePlaces($places);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n $value = (int) floor((float) $value);\n if ($value > self::LARGEST_BINARY_IN_DECIMAL || $value < self::SMALLEST_BINARY_IN_DECIMAL) {\n return ExcelError::NAN();\n }\n\n $r = decbin($value);\n // Two's Complement\n $r = substr($r, -10);\n\n return self::nbrConversionFormat($r, $places);\n }\n\n /**\n * toHex.\n *\n * Return a decimal value as hex.\n *\n * Excel Function:\n * DEC2HEX(x[,places])\n *\n * @param array|bool|float|int|string $value The decimal integer you want to convert. If number is negative,\n * places is ignored and DEC2HEX returns a 10-character (40-bit)\n * hexadecimal number in which the most significant bit is the sign\n * bit. The remaining 39 bits are magnitude bits. Negative numbers\n * are represented using two's-complement notation.\n * If number < -549,755,813,888 or if number > 549,755,813,887,\n * DEC2HEX returns the #NUM! error value.\n * If number is nonnumeric, DEC2HEX returns the #VALUE! error value.\n * If DEC2HEX requires more than places characters, it returns the\n * #NUM! error value.\n * Or can be an array of values\n * @param null|array|float|int|string $places The number of characters to use. If places is omitted, DEC2HEX uses\n * the minimum number of characters necessary. Places is useful for\n * padding the return value with leading 0s (zeros).\n * If places is not an integer, it is truncated.\n * If places is nonnumeric, DEC2HEX returns the #VALUE! error value.\n * If places is zero or negative, DEC2HEX returns the #NUM! error value.\n * Or can be an array of values\n *\n * @return array|string Result, or an error\n * If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function toHex($value, $places = null): array|string\n {\n if (is_array($value) || is_array($places)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $places);\n }\n\n try {\n $value = self::validateValue($value);\n $value = self::validateDecimal($value);\n $places = self::validatePlaces($places);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n $value = floor((float) $value);\n if ($value > self::LARGEST_HEX_IN_DECIMAL || $value < self::SMALLEST_HEX_IN_DECIMAL) {\n return ExcelError::NAN();\n }\n $r = strtoupper(dechex((int) $value));\n $r = self::hex32bit($value, $r);\n\n return self::nbrConversionFormat($r, $places);\n }\n\n public static function hex32bit(float $value, string $hexstr, bool $force = false): string\n {\n if (PHP_INT_SIZE === 4 || $force) {\n if ($value >= 2 ** 32) {\n $quotient = (int) ($value / (2 ** 32));\n\n return strtoupper(substr('0' . dechex($quotient), -2) . $hexstr);\n }\n if ($value < -(2 ** 32)) {\n $quotient = 256 - (int) ceil((-$value) / (2 ** 32));\n\n return strtoupper(substr('0' . dechex($quotient), -2) . substr(\"00000000$hexstr\", -8));\n }\n if ($value < 0) {\n return \"FF$hexstr\";\n }\n }\n\n return $hexstr;\n }\n\n /**\n * toOctal.\n *\n * Return a decimal value as octal.\n *\n * Excel Function:\n * DEC2OCT(x[,places])\n *\n * @param array|bool|float|int|string $value The decimal integer you want to convert. If number is negative,\n * places is ignored and DEC2OCT returns a 10-character (30-bit)\n * octal number in which the most significant bit is the sign bit.\n * The remaining 29 bits are magnitude bits. Negative numbers are\n * represented using two's-complement notation.\n * If number < -536,870,912 or if number > 536,870,911, DEC2OCT\n * returns the #NUM! error value.\n * If number is nonnumeric, DEC2OCT returns the #VALUE! error value.\n * If DEC2OCT requires more than places characters, it returns the\n * #NUM! error value.\n * Or can be an array of values\n * @param array|int $places The number of characters to use. If places is omitted, DEC2OCT uses\n * the minimum number of characters necessary. Places is useful for\n * padding the return value with leading 0s (zeros).\n * If places is not an integer, it is truncated.\n * If places is nonnumeric, DEC2OCT returns the #VALUE! error value.\n * If places is zero or negative, DEC2OCT returns the #NUM! error value.\n * Or can be an array of values\n *\n * @return array|string Result, or an error\n * If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function toOctal($value, $places = null): array|string\n {\n if (is_array($value) || is_array($places)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $places);\n }\n\n try {\n $value = self::validateValue($value);\n $value = self::validateDecimal($value);\n $places = self::validatePlaces($places);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n $value = (int) floor((float) $value);\n if ($value > self::LARGEST_OCTAL_IN_DECIMAL || $value < self::SMALLEST_OCTAL_IN_DECIMAL) {\n return ExcelError::NAN();\n }\n $r = decoct($value);\n $r = substr($r, -10);\n\n return self::nbrConversionFormat($r, $places);\n }\n\n protected static function validateDecimal(string $value): string\n {\n if (strlen($value) > preg_match_all('/[-0123456789.]/', $value)) {\n throw new Exception(ExcelError::VALUE());\n }\n\n return $value;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engineering/ConvertHex.php",
"content": "|bool|float|string $value The hexadecimal number you want to convert.\n * Number cannot contain more than 10 characters.\n * The most significant bit of number is the sign bit (40th bit from the right).\n * The remaining 9 bits are magnitude bits.\n * Negative numbers are represented using two's-complement notation.\n * If number is negative, HEX2BIN ignores places and returns a 10-character binary number.\n * If number is negative, it cannot be less than FFFFFFFE00,\n * and if number is positive, it cannot be greater than 1FF.\n * If number is not a valid hexadecimal number, HEX2BIN returns the #NUM! error value.\n * If HEX2BIN requires more than places characters, it returns the #NUM! error value.\n * Or can be an array of values\n * @param array|int $places The number of characters to use. If places is omitted,\n * HEX2BIN uses the minimum number of characters necessary. Places\n * is useful for padding the return value with leading 0s (zeros).\n * If places is not an integer, it is truncated.\n * If places is nonnumeric, HEX2BIN returns the #VALUE! error value.\n * If places is negative, HEX2BIN returns the #NUM! error value.\n * Or can be an array of values\n *\n * @return array|string Result, or an error\n * If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function toBinary($value, $places = null): array|string\n {\n if (is_array($value) || is_array($places)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $places);\n }\n\n try {\n $value = self::validateValue($value);\n $value = self::validateHex($value);\n $places = self::validatePlaces($places);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n $dec = self::toDecimal($value);\n\n return ConvertDecimal::toBinary($dec, $places);\n }\n\n /**\n * toDecimal.\n *\n * Return a hex value as decimal.\n *\n * Excel Function:\n * HEX2DEC(x)\n *\n * @param array|bool|float|int|string $value The hexadecimal number you want to convert. This number cannot\n * contain more than 10 characters (40 bits). The most significant\n * bit of number is the sign bit. The remaining 39 bits are magnitude\n * bits. Negative numbers are represented using two's-complement\n * notation.\n * If number is not a valid hexadecimal number, HEX2DEC returns the\n * #NUM! error value.\n * Or can be an array of values\n *\n * @return array|float|int|string Result, or an error\n * If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function toDecimal($value)\n {\n if (is_array($value)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $value);\n }\n\n try {\n $value = self::validateValue($value);\n $value = self::validateHex($value);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n if (strlen($value) > 10) {\n return ExcelError::NAN();\n }\n\n $binX = '';\n foreach (mb_str_split($value, 1, 'UTF-8') as $char) {\n $binX .= str_pad(base_convert($char, 16, 2), 4, '0', STR_PAD_LEFT);\n }\n if (strlen($binX) == 40 && $binX[0] == '1') {\n for ($i = 0; $i < 40; ++$i) {\n $binX[$i] = ($binX[$i] == '1' ? '0' : '1');\n }\n\n return (bindec($binX) + 1) * -1;\n }\n\n return bindec($binX);\n }\n\n /**\n * toOctal.\n *\n * Return a hex value as octal.\n *\n * Excel Function:\n * HEX2OCT(x[,places])\n *\n * @param array|bool|float|int|string $value The hexadecimal number you want to convert. Number cannot\n * contain more than 10 characters. The most significant bit of\n * number is the sign bit. The remaining 39 bits are magnitude\n * bits. Negative numbers are represented using two's-complement\n * notation.\n * If number is negative, HEX2OCT ignores places and returns a\n * 10-character octal number.\n * If number is negative, it cannot be less than FFE0000000, and\n * if number is positive, it cannot be greater than 1FFFFFFF.\n * If number is not a valid hexadecimal number, HEX2OCT returns\n * the #NUM! error value.\n * If HEX2OCT requires more than places characters, it returns\n * the #NUM! error value.\n * Or can be an array of values\n * @param array|int $places The number of characters to use. If places is omitted, HEX2OCT\n * uses the minimum number of characters necessary. Places is\n * useful for padding the return value with leading 0s (zeros).\n * If places is not an integer, it is truncated.\n * If places is nonnumeric, HEX2OCT returns the #VALUE! error\n * value.\n * If places is negative, HEX2OCT returns the #NUM! error value.\n * Or can be an array of values\n *\n * @return array|string Result, or an error\n * If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function toOctal($value, $places = null): array|string\n {\n if (is_array($value) || is_array($places)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $places);\n }\n\n try {\n $value = self::validateValue($value);\n $value = self::validateHex($value);\n $places = self::validatePlaces($places);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n $decimal = self::toDecimal($value);\n\n return ConvertDecimal::toOctal($decimal, $places);\n }\n\n protected static function validateHex(string $value): string\n {\n if (strlen($value) > preg_match_all('/[0123456789ABCDEF]/', $value)) {\n throw new Exception(ExcelError::NAN());\n }\n\n return $value;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engineering/ConvertOctal.php",
"content": "|bool|float|int|string $value The octal number you want to convert. Number may not\n * contain more than 10 characters. The most significant\n * bit of number is the sign bit. The remaining 29 bits\n * are magnitude bits. Negative numbers are represented\n * using two's-complement notation.\n * If number is negative, OCT2BIN ignores places and returns\n * a 10-character binary number.\n * If number is negative, it cannot be less than 7777777000,\n * and if number is positive, it cannot be greater than 777.\n * If number is not a valid octal number, OCT2BIN returns\n * the #NUM! error value.\n * If OCT2BIN requires more than places characters, it\n * returns the #NUM! error value.\n * Or can be an array of values\n * @param array|int $places The number of characters to use. If places is omitted,\n * OCT2BIN uses the minimum number of characters necessary.\n * Places is useful for padding the return value with\n * leading 0s (zeros).\n * If places is not an integer, it is truncated.\n * If places is nonnumeric, OCT2BIN returns the #VALUE!\n * error value.\n * If places is negative, OCT2BIN returns the #NUM! error\n * value.\n * Or can be an array of values\n *\n * @return array|string Result, or an error\n * If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function toBinary($value, $places = null): array|string\n {\n if (is_array($value) || is_array($places)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $places);\n }\n\n try {\n $value = self::validateValue($value);\n $value = self::validateOctal($value);\n $places = self::validatePlaces($places);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n return ConvertDecimal::toBinary(self::toDecimal($value), $places);\n }\n\n /**\n * toDecimal.\n *\n * Return an octal value as decimal.\n *\n * Excel Function:\n * OCT2DEC(x)\n *\n * @param array|bool|float|int|string $value The octal number you want to convert. Number may not contain\n * more than 10 octal characters (30 bits). The most significant\n * bit of number is the sign bit. The remaining 29 bits are\n * magnitude bits. Negative numbers are represented using\n * two's-complement notation.\n * If number is not a valid octal number, OCT2DEC returns the\n * #NUM! error value.\n * Or can be an array of values\n *\n * @return array|float|int|string Result, or an error\n * If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function toDecimal($value)\n {\n if (is_array($value)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $value);\n }\n\n try {\n $value = self::validateValue($value);\n $value = self::validateOctal($value);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n $binX = '';\n foreach (mb_str_split($value, 1, 'UTF-8') as $char) {\n $binX .= str_pad(decbin((int) $char), 3, '0', STR_PAD_LEFT);\n }\n if (strlen($binX) == 30 && $binX[0] == '1') {\n for ($i = 0; $i < 30; ++$i) {\n $binX[$i] = ($binX[$i] == '1' ? '0' : '1');\n }\n\n return (bindec($binX) + 1) * -1;\n }\n\n return bindec($binX);\n }\n\n /**\n * toHex.\n *\n * Return an octal value as hex.\n *\n * Excel Function:\n * OCT2HEX(x[,places])\n *\n * @param array|bool|float|int|string $value The octal number you want to convert. Number may not contain\n * more than 10 octal characters (30 bits). The most significant\n * bit of number is the sign bit. The remaining 29 bits are\n * magnitude bits. Negative numbers are represented using\n * two's-complement notation.\n * If number is negative, OCT2HEX ignores places and returns a\n * 10-character hexadecimal number.\n * If number is not a valid octal number, OCT2HEX returns the\n * #NUM! error value.\n * If OCT2HEX requires more than places characters, it returns\n * the #NUM! error value.\n * Or can be an array of values\n * @param array|int $places The number of characters to use. If places is omitted, OCT2HEX\n * uses the minimum number of characters necessary. Places is useful\n * for padding the return value with leading 0s (zeros).\n * If places is not an integer, it is truncated.\n * If places is nonnumeric, OCT2HEX returns the #VALUE! error value.\n * If places is negative, OCT2HEX returns the #NUM! error value.\n * Or can be an array of values\n *\n * @return array|string Result, or an error\n * If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function toHex($value, $places = null): array|string\n {\n if (is_array($value) || is_array($places)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $places);\n }\n\n try {\n $value = self::validateValue($value);\n $value = self::validateOctal($value);\n $places = self::validatePlaces($places);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n $hexVal = strtoupper(dechex((int) self::toDecimal($value)));\n $hexVal = (PHP_INT_SIZE === 4 && strlen($value) === 10 && $value[0] >= '4') ? \"FF{$hexVal}\" : $hexVal;\n\n return self::nbrConversionFormat($hexVal, $places);\n }\n\n protected static function validateOctal(string $value): string\n {\n $numDigits = (int) preg_match_all('/[01234567]/', $value);\n if (strlen($value) > $numDigits || $numDigits > 10) {\n throw new Exception(ExcelError::NAN());\n }\n\n return $value;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engineering/ConvertUOM.php",
"content": "\n */\n private static array $conversionUnits = [\n // Weight and Mass\n 'g' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Gram', 'AllowPrefix' => true],\n 'sg' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Slug', 'AllowPrefix' => false],\n 'lbm' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Pound mass (avoirdupois)', 'AllowPrefix' => false],\n 'u' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'U (atomic mass unit)', 'AllowPrefix' => true],\n 'ozm' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Ounce mass (avoirdupois)', 'AllowPrefix' => false],\n 'grain' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Grain', 'AllowPrefix' => false],\n 'cwt' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'U.S. (short) hundredweight', 'AllowPrefix' => false],\n 'shweight' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'U.S. (short) hundredweight', 'AllowPrefix' => false],\n 'uk_cwt' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Imperial hundredweight', 'AllowPrefix' => false],\n 'lcwt' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Imperial hundredweight', 'AllowPrefix' => false],\n 'hweight' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Imperial hundredweight', 'AllowPrefix' => false],\n 'stone' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Stone', 'AllowPrefix' => false],\n 'ton' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Ton', 'AllowPrefix' => false],\n 'uk_ton' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Imperial ton', 'AllowPrefix' => false],\n 'LTON' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Imperial ton', 'AllowPrefix' => false],\n 'brton' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Imperial ton', 'AllowPrefix' => false],\n // Distance\n 'm' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Meter', 'AllowPrefix' => true],\n 'mi' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Statute mile', 'AllowPrefix' => false],\n 'Nmi' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Nautical mile', 'AllowPrefix' => false],\n 'in' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Inch', 'AllowPrefix' => false],\n 'ft' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Foot', 'AllowPrefix' => false],\n 'yd' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Yard', 'AllowPrefix' => false],\n 'ang' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Angstrom', 'AllowPrefix' => true],\n 'ell' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Ell', 'AllowPrefix' => false],\n 'ly' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Light Year', 'AllowPrefix' => false],\n 'parsec' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Parsec', 'AllowPrefix' => false],\n 'pc' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Parsec', 'AllowPrefix' => false],\n 'Pica' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Pica (1/72 in)', 'AllowPrefix' => false],\n 'Picapt' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Pica (1/72 in)', 'AllowPrefix' => false],\n 'pica' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Pica (1/6 in)', 'AllowPrefix' => false],\n 'survey_mi' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'U.S survey mile (statute mile)', 'AllowPrefix' => false],\n // Time\n 'yr' => ['Group' => self::CATEGORY_TIME, 'UnitName' => 'Year', 'AllowPrefix' => false],\n 'day' => ['Group' => self::CATEGORY_TIME, 'UnitName' => 'Day', 'AllowPrefix' => false],\n 'd' => ['Group' => self::CATEGORY_TIME, 'UnitName' => 'Day', 'AllowPrefix' => false],\n 'hr' => ['Group' => self::CATEGORY_TIME, 'UnitName' => 'Hour', 'AllowPrefix' => false],\n 'mn' => ['Group' => self::CATEGORY_TIME, 'UnitName' => 'Minute', 'AllowPrefix' => false],\n 'min' => ['Group' => self::CATEGORY_TIME, 'UnitName' => 'Minute', 'AllowPrefix' => false],\n 'sec' => ['Group' => self::CATEGORY_TIME, 'UnitName' => 'Second', 'AllowPrefix' => true],\n 's' => ['Group' => self::CATEGORY_TIME, 'UnitName' => 'Second', 'AllowPrefix' => true],\n // Pressure\n 'Pa' => ['Group' => self::CATEGORY_PRESSURE, 'UnitName' => 'Pascal', 'AllowPrefix' => true],\n 'p' => ['Group' => self::CATEGORY_PRESSURE, 'UnitName' => 'Pascal', 'AllowPrefix' => true],\n 'atm' => ['Group' => self::CATEGORY_PRESSURE, 'UnitName' => 'Atmosphere', 'AllowPrefix' => true],\n 'at' => ['Group' => self::CATEGORY_PRESSURE, 'UnitName' => 'Atmosphere', 'AllowPrefix' => true],\n 'mmHg' => ['Group' => self::CATEGORY_PRESSURE, 'UnitName' => 'mm of Mercury', 'AllowPrefix' => true],\n 'psi' => ['Group' => self::CATEGORY_PRESSURE, 'UnitName' => 'PSI', 'AllowPrefix' => true],\n 'Torr' => ['Group' => self::CATEGORY_PRESSURE, 'UnitName' => 'Torr', 'AllowPrefix' => true],\n // Force\n 'N' => ['Group' => self::CATEGORY_FORCE, 'UnitName' => 'Newton', 'AllowPrefix' => true],\n 'dyn' => ['Group' => self::CATEGORY_FORCE, 'UnitName' => 'Dyne', 'AllowPrefix' => true],\n 'dy' => ['Group' => self::CATEGORY_FORCE, 'UnitName' => 'Dyne', 'AllowPrefix' => true],\n 'lbf' => ['Group' => self::CATEGORY_FORCE, 'UnitName' => 'Pound force', 'AllowPrefix' => false],\n 'pond' => ['Group' => self::CATEGORY_FORCE, 'UnitName' => 'Pond', 'AllowPrefix' => true],\n // Energy\n 'J' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'Joule', 'AllowPrefix' => true],\n 'e' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'Erg', 'AllowPrefix' => true],\n 'c' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'Thermodynamic calorie', 'AllowPrefix' => true],\n 'cal' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'IT calorie', 'AllowPrefix' => true],\n 'eV' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'Electron volt', 'AllowPrefix' => true],\n 'ev' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'Electron volt', 'AllowPrefix' => true],\n 'HPh' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'Horsepower-hour', 'AllowPrefix' => false],\n 'hh' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'Horsepower-hour', 'AllowPrefix' => false],\n 'Wh' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'Watt-hour', 'AllowPrefix' => true],\n 'wh' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'Watt-hour', 'AllowPrefix' => true],\n 'flb' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'Foot-pound', 'AllowPrefix' => false],\n 'BTU' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'BTU', 'AllowPrefix' => false],\n 'btu' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'BTU', 'AllowPrefix' => false],\n // Power\n 'HP' => ['Group' => self::CATEGORY_POWER, 'UnitName' => 'Horsepower', 'AllowPrefix' => false],\n 'h' => ['Group' => self::CATEGORY_POWER, 'UnitName' => 'Horsepower', 'AllowPrefix' => false],\n 'W' => ['Group' => self::CATEGORY_POWER, 'UnitName' => 'Watt', 'AllowPrefix' => true],\n 'w' => ['Group' => self::CATEGORY_POWER, 'UnitName' => 'Watt', 'AllowPrefix' => true],\n 'PS' => ['Group' => self::CATEGORY_POWER, 'UnitName' => 'Pferdestärke', 'AllowPrefix' => false],\n // Magnetism\n 'T' => ['Group' => self::CATEGORY_MAGNETISM, 'UnitName' => 'Tesla', 'AllowPrefix' => true],\n 'ga' => ['Group' => self::CATEGORY_MAGNETISM, 'UnitName' => 'Gauss', 'AllowPrefix' => true],\n // Temperature\n 'C' => ['Group' => self::CATEGORY_TEMPERATURE, 'UnitName' => 'Degrees Celsius', 'AllowPrefix' => false],\n 'cel' => ['Group' => self::CATEGORY_TEMPERATURE, 'UnitName' => 'Degrees Celsius', 'AllowPrefix' => false],\n 'F' => ['Group' => self::CATEGORY_TEMPERATURE, 'UnitName' => 'Degrees Fahrenheit', 'AllowPrefix' => false],\n 'fah' => ['Group' => self::CATEGORY_TEMPERATURE, 'UnitName' => 'Degrees Fahrenheit', 'AllowPrefix' => false],\n 'K' => ['Group' => self::CATEGORY_TEMPERATURE, 'UnitName' => 'Kelvin', 'AllowPrefix' => false],\n 'kel' => ['Group' => self::CATEGORY_TEMPERATURE, 'UnitName' => 'Kelvin', 'AllowPrefix' => false],\n 'Rank' => ['Group' => self::CATEGORY_TEMPERATURE, 'UnitName' => 'Degrees Rankine', 'AllowPrefix' => false],\n 'Reau' => ['Group' => self::CATEGORY_TEMPERATURE, 'UnitName' => 'Degrees Réaumur', 'AllowPrefix' => false],\n // Volume\n 'l' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Litre', 'AllowPrefix' => true],\n 'L' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Litre', 'AllowPrefix' => true],\n 'lt' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Litre', 'AllowPrefix' => true],\n 'tsp' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Teaspoon', 'AllowPrefix' => false],\n 'tspm' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Modern Teaspoon', 'AllowPrefix' => false],\n 'tbs' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Tablespoon', 'AllowPrefix' => false],\n 'oz' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Fluid Ounce', 'AllowPrefix' => false],\n 'cup' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cup', 'AllowPrefix' => false],\n 'pt' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'U.S. Pint', 'AllowPrefix' => false],\n 'us_pt' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'U.S. Pint', 'AllowPrefix' => false],\n 'uk_pt' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'U.K. Pint', 'AllowPrefix' => false],\n 'qt' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Quart', 'AllowPrefix' => false],\n 'uk_qt' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Imperial Quart (UK)', 'AllowPrefix' => false],\n 'gal' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Gallon', 'AllowPrefix' => false],\n 'uk_gal' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Imperial Gallon (UK)', 'AllowPrefix' => false],\n 'ang3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Angstrom', 'AllowPrefix' => true],\n 'ang^3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Angstrom', 'AllowPrefix' => true],\n 'barrel' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'US Oil Barrel', 'AllowPrefix' => false],\n 'bushel' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'US Bushel', 'AllowPrefix' => false],\n 'in3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Inch', 'AllowPrefix' => false],\n 'in^3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Inch', 'AllowPrefix' => false],\n 'ft3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Foot', 'AllowPrefix' => false],\n 'ft^3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Foot', 'AllowPrefix' => false],\n 'ly3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Light Year', 'AllowPrefix' => false],\n 'ly^3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Light Year', 'AllowPrefix' => false],\n 'm3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Meter', 'AllowPrefix' => true],\n 'm^3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Meter', 'AllowPrefix' => true],\n 'mi3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Mile', 'AllowPrefix' => false],\n 'mi^3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Mile', 'AllowPrefix' => false],\n 'yd3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Yard', 'AllowPrefix' => false],\n 'yd^3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Yard', 'AllowPrefix' => false],\n 'Nmi3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Nautical Mile', 'AllowPrefix' => false],\n 'Nmi^3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Nautical Mile', 'AllowPrefix' => false],\n 'Pica3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Pica', 'AllowPrefix' => false],\n 'Pica^3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Pica', 'AllowPrefix' => false],\n 'Picapt3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Pica', 'AllowPrefix' => false],\n 'Picapt^3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Pica', 'AllowPrefix' => false],\n 'GRT' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Gross Registered Ton', 'AllowPrefix' => false],\n 'regton' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Gross Registered Ton', 'AllowPrefix' => false],\n 'MTON' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Measurement Ton (Freight Ton)', 'AllowPrefix' => false],\n // Area\n 'ha' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Hectare', 'AllowPrefix' => true],\n 'uk_acre' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'International Acre', 'AllowPrefix' => false],\n 'us_acre' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'US Survey/Statute Acre', 'AllowPrefix' => false],\n 'ang2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Angstrom', 'AllowPrefix' => true],\n 'ang^2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Angstrom', 'AllowPrefix' => true],\n 'ar' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Are', 'AllowPrefix' => true],\n 'ft2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Feet', 'AllowPrefix' => false],\n 'ft^2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Feet', 'AllowPrefix' => false],\n 'in2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Inches', 'AllowPrefix' => false],\n 'in^2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Inches', 'AllowPrefix' => false],\n 'ly2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Light Years', 'AllowPrefix' => false],\n 'ly^2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Light Years', 'AllowPrefix' => false],\n 'm2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Meters', 'AllowPrefix' => true],\n 'm^2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Meters', 'AllowPrefix' => true],\n 'Morgen' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Morgen', 'AllowPrefix' => false],\n 'mi2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Miles', 'AllowPrefix' => false],\n 'mi^2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Miles', 'AllowPrefix' => false],\n 'Nmi2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Nautical Miles', 'AllowPrefix' => false],\n 'Nmi^2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Nautical Miles', 'AllowPrefix' => false],\n 'Pica2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Pica', 'AllowPrefix' => false],\n 'Pica^2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Pica', 'AllowPrefix' => false],\n 'Picapt2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Pica', 'AllowPrefix' => false],\n 'Picapt^2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Pica', 'AllowPrefix' => false],\n 'yd2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Yards', 'AllowPrefix' => false],\n 'yd^2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Yards', 'AllowPrefix' => false],\n // Information\n 'byte' => ['Group' => self::CATEGORY_INFORMATION, 'UnitName' => 'Byte', 'AllowPrefix' => true],\n 'bit' => ['Group' => self::CATEGORY_INFORMATION, 'UnitName' => 'Bit', 'AllowPrefix' => true],\n // Speed\n 'm/s' => ['Group' => self::CATEGORY_SPEED, 'UnitName' => 'Meters per second', 'AllowPrefix' => true],\n 'm/sec' => ['Group' => self::CATEGORY_SPEED, 'UnitName' => 'Meters per second', 'AllowPrefix' => true],\n 'm/h' => ['Group' => self::CATEGORY_SPEED, 'UnitName' => 'Meters per hour', 'AllowPrefix' => true],\n 'm/hr' => ['Group' => self::CATEGORY_SPEED, 'UnitName' => 'Meters per hour', 'AllowPrefix' => true],\n 'mph' => ['Group' => self::CATEGORY_SPEED, 'UnitName' => 'Miles per hour', 'AllowPrefix' => false],\n 'admkn' => ['Group' => self::CATEGORY_SPEED, 'UnitName' => 'Admiralty Knot', 'AllowPrefix' => false],\n 'kn' => ['Group' => self::CATEGORY_SPEED, 'UnitName' => 'Knot', 'AllowPrefix' => false],\n ];\n\n /**\n * Details of the Multiplier prefixes that can be used with Units of Measure in CONVERTUOM().\n *\n * @var array\n */\n private static array $conversionMultipliers = [\n 'Y' => ['multiplier' => 1E24, 'name' => 'yotta'],\n 'Z' => ['multiplier' => 1E21, 'name' => 'zetta'],\n 'E' => ['multiplier' => 1E18, 'name' => 'exa'],\n 'P' => ['multiplier' => 1E15, 'name' => 'peta'],\n 'T' => ['multiplier' => 1E12, 'name' => 'tera'],\n 'G' => ['multiplier' => 1E9, 'name' => 'giga'],\n 'M' => ['multiplier' => 1E6, 'name' => 'mega'],\n 'k' => ['multiplier' => 1E3, 'name' => 'kilo'],\n 'h' => ['multiplier' => 1E2, 'name' => 'hecto'],\n 'e' => ['multiplier' => 1E1, 'name' => 'dekao'],\n 'da' => ['multiplier' => 1E1, 'name' => 'dekao'],\n 'd' => ['multiplier' => 1E-1, 'name' => 'deci'],\n 'c' => ['multiplier' => 1E-2, 'name' => 'centi'],\n 'm' => ['multiplier' => 1E-3, 'name' => 'milli'],\n 'u' => ['multiplier' => 1E-6, 'name' => 'micro'],\n 'n' => ['multiplier' => 1E-9, 'name' => 'nano'],\n 'p' => ['multiplier' => 1E-12, 'name' => 'pico'],\n 'f' => ['multiplier' => 1E-15, 'name' => 'femto'],\n 'a' => ['multiplier' => 1E-18, 'name' => 'atto'],\n 'z' => ['multiplier' => 1E-21, 'name' => 'zepto'],\n 'y' => ['multiplier' => 1E-24, 'name' => 'yocto'],\n ];\n\n /**\n * Details of the Multiplier prefixes that can be used with Units of Measure in CONVERTUOM().\n *\n * @var array\n */\n private static array $binaryConversionMultipliers = [\n 'Yi' => ['multiplier' => 2 ** 80, 'name' => 'yobi'],\n 'Zi' => ['multiplier' => 2 ** 70, 'name' => 'zebi'],\n 'Ei' => ['multiplier' => 2 ** 60, 'name' => 'exbi'],\n 'Pi' => ['multiplier' => 2 ** 50, 'name' => 'pebi'],\n 'Ti' => ['multiplier' => 2 ** 40, 'name' => 'tebi'],\n 'Gi' => ['multiplier' => 2 ** 30, 'name' => 'gibi'],\n 'Mi' => ['multiplier' => 2 ** 20, 'name' => 'mebi'],\n 'ki' => ['multiplier' => 2 ** 10, 'name' => 'kibi'],\n ];\n\n /**\n * Details of the Units of measure conversion factors, organised by group.\n *\n * @var array>\n */\n private static array $unitConversions = [\n // Conversion uses gram (g) as an intermediate unit\n self::CATEGORY_WEIGHT_AND_MASS => [\n 'g' => 1.0,\n 'sg' => 6.85217658567918E-05,\n 'lbm' => 2.20462262184878E-03,\n 'u' => 6.02214179421676E+23,\n 'ozm' => 3.52739619495804E-02,\n 'grain' => 1.54323583529414E+01,\n 'cwt' => 2.20462262184878E-05,\n 'shweight' => 2.20462262184878E-05,\n 'uk_cwt' => 1.96841305522212E-05,\n 'lcwt' => 1.96841305522212E-05,\n 'hweight' => 1.96841305522212E-05,\n 'stone' => 1.57473044417770E-04,\n 'ton' => 1.10231131092439E-06,\n 'uk_ton' => 9.84206527611061E-07,\n 'LTON' => 9.84206527611061E-07,\n 'brton' => 9.84206527611061E-07,\n ],\n // Conversion uses meter (m) as an intermediate unit\n self::CATEGORY_DISTANCE => [\n 'm' => 1.0,\n 'mi' => 6.21371192237334E-04,\n 'Nmi' => 5.39956803455724E-04,\n 'in' => 3.93700787401575E+01,\n 'ft' => 3.28083989501312E+00,\n 'yd' => 1.09361329833771E+00,\n 'ang' => 1.0E+10,\n 'ell' => 8.74890638670166E-01,\n 'ly' => 1.05700083402462E-16,\n 'parsec' => 3.24077928966473E-17,\n 'pc' => 3.24077928966473E-17,\n 'Pica' => 2.83464566929134E+03,\n 'Picapt' => 2.83464566929134E+03,\n 'pica' => 2.36220472440945E+02,\n 'survey_mi' => 6.21369949494950E-04,\n ],\n // Conversion uses second (s) as an intermediate unit\n self::CATEGORY_TIME => [\n 'yr' => 3.16880878140289E-08,\n 'day' => 1.15740740740741E-05,\n 'd' => 1.15740740740741E-05,\n 'hr' => 2.77777777777778E-04,\n 'mn' => 1.66666666666667E-02,\n 'min' => 1.66666666666667E-02,\n 'sec' => 1.0,\n 's' => 1.0,\n ],\n // Conversion uses Pascal (Pa) as an intermediate unit\n self::CATEGORY_PRESSURE => [\n 'Pa' => 1.0,\n 'p' => 1.0,\n 'atm' => 9.86923266716013E-06,\n 'at' => 9.86923266716013E-06,\n 'mmHg' => 7.50063755419211E-03,\n 'psi' => 1.45037737730209E-04,\n 'Torr' => 7.50061682704170E-03,\n ],\n // Conversion uses Newton (N) as an intermediate unit\n self::CATEGORY_FORCE => [\n 'N' => 1.0,\n 'dyn' => 1.0E+5,\n 'dy' => 1.0E+5,\n 'lbf' => 2.24808923655339E-01,\n 'pond' => 1.01971621297793E+02,\n ],\n // Conversion uses Joule (J) as an intermediate unit\n self::CATEGORY_ENERGY => [\n 'J' => 1.0,\n 'e' => 9.99999519343231E+06,\n 'c' => 2.39006249473467E-01,\n 'cal' => 2.38846190642017E-01,\n 'eV' => 6.24145700000000E+18,\n 'ev' => 6.24145700000000E+18,\n 'HPh' => 3.72506430801000E-07,\n 'hh' => 3.72506430801000E-07,\n 'Wh' => 2.77777916238711E-04,\n 'wh' => 2.77777916238711E-04,\n 'flb' => 2.37304222192651E+01,\n 'BTU' => 9.47815067349015E-04,\n 'btu' => 9.47815067349015E-04,\n ],\n // Conversion uses Horsepower (HP) as an intermediate unit\n self::CATEGORY_POWER => [\n 'HP' => 1.0,\n 'h' => 1.0,\n 'W' => 7.45699871582270E+02,\n 'w' => 7.45699871582270E+02,\n 'PS' => 1.01386966542400E+00,\n ],\n // Conversion uses Tesla (T) as an intermediate unit\n self::CATEGORY_MAGNETISM => [\n 'T' => 1.0,\n 'ga' => 10000.0,\n ],\n // Conversion uses litre (l) as an intermediate unit\n self::CATEGORY_VOLUME => [\n 'l' => 1.0,\n 'L' => 1.0,\n 'lt' => 1.0,\n 'tsp' => 2.02884136211058E+02,\n 'tspm' => 2.0E+02,\n 'tbs' => 6.76280454036860E+01,\n 'oz' => 3.38140227018430E+01,\n 'cup' => 4.22675283773038E+00,\n 'pt' => 2.11337641886519E+00,\n 'us_pt' => 2.11337641886519E+00,\n 'uk_pt' => 1.75975398639270E+00,\n 'qt' => 1.05668820943259E+00,\n 'uk_qt' => 8.79876993196351E-01,\n 'gal' => 2.64172052358148E-01,\n 'uk_gal' => 2.19969248299088E-01,\n 'ang3' => 1.0E+27,\n 'ang^3' => 1.0E+27,\n 'barrel' => 6.28981077043211E-03,\n 'bushel' => 2.83775932584017E-02,\n 'in3' => 6.10237440947323E+01,\n 'in^3' => 6.10237440947323E+01,\n 'ft3' => 3.53146667214886E-02,\n 'ft^3' => 3.53146667214886E-02,\n 'ly3' => 1.18093498844171E-51,\n 'ly^3' => 1.18093498844171E-51,\n 'm3' => 1.0E-03,\n 'm^3' => 1.0E-03,\n 'mi3' => 2.39912758578928E-13,\n 'mi^3' => 2.39912758578928E-13,\n 'yd3' => 1.30795061931439E-03,\n 'yd^3' => 1.30795061931439E-03,\n 'Nmi3' => 1.57426214685811E-13,\n 'Nmi^3' => 1.57426214685811E-13,\n 'Pica3' => 2.27769904358706E+07,\n 'Pica^3' => 2.27769904358706E+07,\n 'Picapt3' => 2.27769904358706E+07,\n 'Picapt^3' => 2.27769904358706E+07,\n 'GRT' => 3.53146667214886E-04,\n 'regton' => 3.53146667214886E-04,\n 'MTON' => 8.82866668037215E-04,\n ],\n // Conversion uses hectare (ha) as an intermediate unit\n self::CATEGORY_AREA => [\n 'ha' => 1.0,\n 'uk_acre' => 2.47105381467165E+00,\n 'us_acre' => 2.47104393046628E+00,\n 'ang2' => 1.0E+24,\n 'ang^2' => 1.0E+24,\n 'ar' => 1.0E+02,\n 'ft2' => 1.07639104167097E+05,\n 'ft^2' => 1.07639104167097E+05,\n 'in2' => 1.55000310000620E+07,\n 'in^2' => 1.55000310000620E+07,\n 'ly2' => 1.11725076312873E-28,\n 'ly^2' => 1.11725076312873E-28,\n 'm2' => 1.0E+04,\n 'm^2' => 1.0E+04,\n 'Morgen' => 4.0E+00,\n 'mi2' => 3.86102158542446E-03,\n 'mi^2' => 3.86102158542446E-03,\n 'Nmi2' => 2.91553349598123E-03,\n 'Nmi^2' => 2.91553349598123E-03,\n 'Pica2' => 8.03521607043214E+10,\n 'Pica^2' => 8.03521607043214E+10,\n 'Picapt2' => 8.03521607043214E+10,\n 'Picapt^2' => 8.03521607043214E+10,\n 'yd2' => 1.19599004630108E+04,\n 'yd^2' => 1.19599004630108E+04,\n ],\n // Conversion uses bit (bit) as an intermediate unit\n self::CATEGORY_INFORMATION => [\n 'bit' => 1.0,\n 'byte' => 0.125,\n ],\n // Conversion uses Meters per Second (m/s) as an intermediate unit\n self::CATEGORY_SPEED => [\n 'm/s' => 1.0,\n 'm/sec' => 1.0,\n 'm/h' => 3.60E+03,\n 'm/hr' => 3.60E+03,\n 'mph' => 2.23693629205440E+00,\n 'admkn' => 1.94260256941567E+00,\n 'kn' => 1.94384449244060E+00,\n ],\n ];\n\n /**\n * getConversionGroups\n * Returns a list of the different conversion groups for UOM conversions.\n *\n * @return string[]\n */\n public static function getConversionCategories(): array\n {\n $conversionGroups = [];\n foreach (self::$conversionUnits as $conversionUnit) {\n $conversionGroups[] = $conversionUnit['Group'];\n }\n\n return array_merge(array_unique($conversionGroups));\n }\n\n /**\n * getConversionGroupUnits\n * Returns an array of units of measure, for a specified conversion group, or for all groups.\n *\n * @param ?string $category The group whose units of measure you want to retrieve\n *\n * @return string[][]\n */\n public static function getConversionCategoryUnits(?string $category = null): array\n {\n $conversionGroups = [];\n foreach (self::$conversionUnits as $conversionUnit => $conversionGroup) {\n if (($category === null) || ($conversionGroup['Group'] == $category)) {\n $conversionGroups[$conversionGroup['Group']][] = $conversionUnit;\n }\n }\n\n return $conversionGroups;\n }\n\n /**\n * getConversionGroupUnitDetails.\n *\n * @param ?string $category The group whose units of measure you want to retrieve\n *\n * @return array>>\n */\n public static function getConversionCategoryUnitDetails(?string $category = null): array\n {\n $conversionGroups = [];\n foreach (self::$conversionUnits as $conversionUnit => $conversionGroup) {\n if (($category === null) || ($conversionGroup['Group'] == $category)) {\n $conversionGroups[$conversionGroup['Group']][] = [\n 'unit' => $conversionUnit,\n 'description' => $conversionGroup['UnitName'],\n ];\n }\n }\n\n return $conversionGroups;\n }\n\n /**\n * getConversionMultipliers\n * Returns an array of the Multiplier prefixes that can be used with Units of Measure in CONVERTUOM().\n *\n * @return array\n */\n public static function getConversionMultipliers(): array\n {\n return self::$conversionMultipliers;\n }\n\n /**\n * getBinaryConversionMultipliers\n * Returns an array of the additional Multiplier prefixes that can be used with Information Units of Measure in CONVERTUOM().\n *\n * @return array\n */\n public static function getBinaryConversionMultipliers(): array\n {\n return self::$binaryConversionMultipliers;\n }\n\n /**\n * CONVERT.\n *\n * Converts a number from one measurement system to another.\n * For example, CONVERT can translate a table of distances in miles to a table of distances\n * in kilometers.\n *\n * Excel Function:\n * CONVERT(value,fromUOM,toUOM)\n *\n * @param array|float|int|string $value the value in fromUOM to convert\n * Or can be an array of values\n * @param string|string[] $fromUOM the units for value\n * Or can be an array of values\n * @param string|string[] $toUOM the units for the result\n * Or can be an array of values\n *\n * @return float|mixed[]|string Result, or a string containing an error\n * If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function CONVERT($value, $fromUOM, $toUOM)\n {\n if (is_array($value) || is_array($fromUOM) || is_array($toUOM)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $fromUOM, $toUOM);\n }\n\n if (!is_numeric($value)) {\n return ExcelError::VALUE();\n }\n\n try {\n [$fromUOM, $fromCategory, $fromMultiplier] = self::getUOMDetails($fromUOM);\n [$toUOM, $toCategory, $toMultiplier] = self::getUOMDetails($toUOM);\n } catch (Exception) {\n return ExcelError::NA();\n }\n\n if ($fromCategory !== $toCategory) {\n return ExcelError::NA();\n }\n\n // @var float $value\n $value *= $fromMultiplier;\n\n if (($fromUOM === $toUOM) && ($fromMultiplier === $toMultiplier)) {\n // We've already factored $fromMultiplier into the value, so we need\n // to reverse it again\n return $value / $fromMultiplier;\n } elseif ($fromUOM === $toUOM) {\n return $value / $toMultiplier;\n } elseif ($fromCategory === self::CATEGORY_TEMPERATURE) {\n return self::convertTemperature($fromUOM, $toUOM, $value);\n }\n\n $baseValue = $value * (1.0 / self::$unitConversions[$fromCategory][$fromUOM]);\n\n return ($baseValue * self::$unitConversions[$fromCategory][$toUOM]) / $toMultiplier;\n }\n\n /** @return array{0: string, 1: string, 2: float} */\n private static function getUOMDetails(string $uom): array\n {\n if (isset(self::$conversionUnits[$uom])) {\n $unitCategory = self::$conversionUnits[$uom]['Group'];\n\n return [$uom, $unitCategory, 1.0];\n }\n\n // Check 1-character standard metric multiplier prefixes\n $multiplierType = substr($uom, 0, 1);\n $uom = substr($uom, 1);\n if (isset(self::$conversionUnits[$uom], self::$conversionMultipliers[$multiplierType])) {\n if (self::$conversionUnits[$uom]['AllowPrefix'] === false) {\n throw new Exception('Prefix not allowed for UoM');\n }\n $unitCategory = self::$conversionUnits[$uom]['Group'];\n\n return [$uom, $unitCategory, self::$conversionMultipliers[$multiplierType]['multiplier']];\n }\n\n $multiplierType .= substr($uom, 0, 1);\n $uom = substr($uom, 1);\n\n // Check 2-character standard metric multiplier prefixes\n if (isset(self::$conversionUnits[$uom], self::$conversionMultipliers[$multiplierType])) {\n if (self::$conversionUnits[$uom]['AllowPrefix'] === false) {\n throw new Exception('Prefix not allowed for UoM');\n }\n $unitCategory = self::$conversionUnits[$uom]['Group'];\n\n return [$uom, $unitCategory, self::$conversionMultipliers[$multiplierType]['multiplier']];\n }\n\n // Check 2-character binary multiplier prefixes\n if (isset(self::$conversionUnits[$uom], self::$binaryConversionMultipliers[$multiplierType])) {\n if (self::$conversionUnits[$uom]['AllowPrefix'] === false) {\n throw new Exception('Prefix not allowed for UoM');\n }\n $unitCategory = self::$conversionUnits[$uom]['Group'];\n if ($unitCategory !== 'Information') {\n throw new Exception('Binary Prefix is only allowed for Information UoM');\n }\n\n return [$uom, $unitCategory, self::$binaryConversionMultipliers[$multiplierType]['multiplier']];\n }\n\n throw new Exception('UoM Not Found');\n }\n\n protected static function convertTemperature(string $fromUOM, string $toUOM, float|int $value): float|int\n {\n $fromUOM = self::resolveTemperatureSynonyms($fromUOM);\n $toUOM = self::resolveTemperatureSynonyms($toUOM);\n\n if ($fromUOM === $toUOM) {\n return $value;\n }\n\n // Convert to Kelvin\n switch ($fromUOM) {\n case 'F':\n $value = ($value - 32) / 1.8 + 273.15;\n\n break;\n case 'C':\n $value += 273.15;\n\n break;\n case 'Rank':\n $value /= 1.8;\n\n break;\n case 'Reau':\n $value = $value * 1.25 + 273.15;\n\n break;\n }\n\n // Convert from Kelvin\n switch ($toUOM) {\n case 'F':\n $value = ($value - 273.15) * 1.8 + 32.00;\n\n break;\n case 'C':\n $value -= 273.15;\n\n break;\n case 'Rank':\n $value *= 1.8;\n\n break;\n case 'Reau':\n $value = ($value - 273.15) * 0.80000;\n\n break;\n }\n\n return $value;\n }\n\n private static function resolveTemperatureSynonyms(string $uom): string\n {\n return match ($uom) {\n 'fah' => 'F',\n 'cel' => 'C',\n 'kel' => 'K',\n default => $uom,\n };\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engineering/EngineeringValidations.php",
"content": "|float|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function ERF(mixed $lower, mixed $upper = null): array|float|string\n {\n if (is_array($lower) || is_array($upper)) {\n return self::evaluateArrayArguments([self::class, __FUNCTION__], $lower, $upper);\n }\n\n if (is_numeric($lower)) {\n if ($upper === null) {\n return self::erfValue($lower);\n }\n if (is_numeric($upper)) {\n return self::erfValue($upper) - self::erfValue($lower);\n }\n }\n\n return ExcelError::VALUE();\n }\n\n /**\n * ERFPRECISE.\n *\n * Returns the error function integrated between the lower and upper bound arguments.\n *\n * Excel Function:\n * ERF.PRECISE(limit)\n *\n * @param mixed $limit Float bound for integrating ERF, other bound is zero\n * Or can be an array of values\n *\n * @return array|float|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function ERFPRECISE(mixed $limit)\n {\n if (is_array($limit)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $limit);\n }\n\n return self::ERF($limit);\n }\n\n private static function makeFloat(mixed $value): float\n {\n return is_numeric($value) ? ((float) $value) : 0.0;\n }\n\n /**\n * Method to calculate the erf value.\n */\n public static function erfValue(float|int|string $value): float\n {\n $value = (float) $value;\n if (abs($value) > 2.2) {\n return 1 - self::makeFloat(ErfC::ERFC($value));\n }\n $sum = $term = $value;\n $xsqr = ($value * $value);\n $j = 1;\n do {\n $term *= $xsqr / $j;\n $sum -= $term / (2 * $j + 1);\n ++$j;\n $term *= $xsqr / $j;\n $sum += $term / (2 * $j + 1);\n ++$j;\n if ($sum == 0.0) {\n break;\n }\n } while (abs($term / $sum) > Functions::PRECISION);\n\n return self::TWO_SQRT_PI * $sum;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Engineering/ErfC.php",
"content": "|float|string If an array of numbers is passed as an argument, then the returned result will also be an array\n * with the same dimensions\n */\n public static function ERFC(mixed $value)\n {\n if (is_array($value)) {\n return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $value);\n }\n\n if (is_numeric($value)) {\n return self::erfcValue($value);\n }\n\n return ExcelError::VALUE();\n }\n\n private const ONE_SQRT_PI = 0.564189583547756287;\n\n /**\n * Method to calculate the erfc value.\n */\n private static function erfcValue(float|int|string $value): float|int\n {\n $value = (float) $value;\n if (abs($value) < 2.2) {\n return 1 - Erf::erfValue($value);\n }\n if ($value < 0) {\n return 2 - self::erfcValue(-$value);\n }\n $a = $n = 1;\n $b = $c = $value;\n $d = ($value * $value) + 0.5;\n $q2 = $b / $d;\n do {\n $t = $a * $n + $b * $value;\n $a = $b;\n $b = $t;\n $t = $c * $n + $d * $value;\n $c = $d;\n $d = $t;\n $n += 0.5;\n $q1 = $q2;\n $q2 = $b / $d;\n } while ((abs($q1 - $q2) / $q2) > Functions::PRECISION);\n\n return self::ONE_SQRT_PI * exp(-$value * $value) * $q2;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Exception.php",
"content": "line = $line;\n $e->file = $file;\n\n throw $e;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/ExceptionHandler.php",
"content": "getMessage();\n }\n\n $yearFracx = DateTimeExcel\\YearFrac::fraction($purchased, $firstPeriod, $basis);\n if (is_string($yearFracx)) {\n return $yearFracx;\n }\n /** @var float $yearFrac */\n $yearFrac = $yearFracx;\n\n $amortiseCoeff = self::getAmortizationCoefficient($rate);\n\n $rate *= $amortiseCoeff;\n $rate = (float) (string) $rate; // ugly way to avoid rounding problem\n $fNRate = round($yearFrac * $rate * $cost, 0);\n $cost -= $fNRate;\n $fRest = $cost - $salvage;\n\n for ($n = 0; $n < $period; ++$n) {\n $fNRate = round($rate * $cost, 0);\n $fRest -= $fNRate;\n\n if ($fRest < 0.0) {\n return match ($period - $n) {\n 1 => round($cost * 0.5, 0),\n default => 0.0,\n };\n }\n $cost -= $fNRate;\n }\n\n return $fNRate;\n }\n\n /**\n * AMORLINC.\n *\n * Returns the depreciation for each accounting period.\n * This function is provided for the French accounting system. If an asset is purchased in\n * the middle of the accounting period, the prorated depreciation is taken into account.\n *\n * Excel Function:\n * AMORLINC(cost,purchased,firstPeriod,salvage,period,rate[,basis])\n *\n * @param mixed $cost The cost of the asset as a float\n * @param mixed $purchased Date of the purchase of the asset\n * @param mixed $firstPeriod Date of the end of the first period\n * @param mixed $salvage The salvage value at the end of the life of the asset\n * @param mixed $period The period as a float\n * @param mixed $rate Rate of depreciation as float\n * @param mixed $basis Integer indicating the type of day count to use.\n * 0 or omitted US (NASD) 30/360\n * 1 Actual/actual\n * 2 Actual/360\n * 3 Actual/365\n * 4 European 30/360\n *\n * @return float|string (string containing the error type if there is an error)\n */\n public static function AMORLINC(\n mixed $cost,\n mixed $purchased,\n mixed $firstPeriod,\n mixed $salvage,\n mixed $period,\n mixed $rate,\n mixed $basis = FinancialConstants::BASIS_DAYS_PER_YEAR_NASD\n ): string|float {\n $cost = Functions::flattenSingleValue($cost);\n $purchased = Functions::flattenSingleValue($purchased);\n $firstPeriod = Functions::flattenSingleValue($firstPeriod);\n $salvage = Functions::flattenSingleValue($salvage);\n $period = Functions::flattenSingleValue($period);\n $rate = Functions::flattenSingleValue($rate);\n $basis = Functions::flattenSingleValue($basis) ?? FinancialConstants::BASIS_DAYS_PER_YEAR_NASD;\n\n try {\n $cost = FinancialValidations::validateFloat($cost);\n $purchased = FinancialValidations::validateDate($purchased);\n $firstPeriod = FinancialValidations::validateDate($firstPeriod);\n $salvage = FinancialValidations::validateFloat($salvage);\n $period = FinancialValidations::validateFloat($period);\n $rate = FinancialValidations::validateFloat($rate);\n $basis = FinancialValidations::validateBasis($basis);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n $fOneRate = $cost * $rate;\n $fCostDelta = $cost - $salvage;\n // Note, quirky variation for leap years on the YEARFRAC for this function\n $purchasedYear = DateTimeExcel\\DateParts::year($purchased);\n $yearFracx = DateTimeExcel\\YearFrac::fraction($purchased, $firstPeriod, $basis);\n if (is_string($yearFracx)) {\n return $yearFracx;\n }\n /** @var float $yearFrac */\n $yearFrac = $yearFracx;\n\n if (\n $basis == FinancialConstants::BASIS_DAYS_PER_YEAR_ACTUAL\n && $yearFrac < 1\n ) {\n $temp = Functions::scalar($purchasedYear);\n if (is_int($temp) || is_string($temp)) {\n if (DateTimeExcel\\Helpers::isLeapYear($temp)) {\n $yearFrac *= 365 / 366;\n }\n }\n }\n\n $f0Rate = $yearFrac * $rate * $cost;\n $nNumOfFullPeriods = (int) (($cost - $salvage - $f0Rate) / $fOneRate);\n\n if ($period == 0) {\n return $f0Rate;\n } elseif ($period <= $nNumOfFullPeriods) {\n return $fOneRate;\n } elseif ($period == ($nNumOfFullPeriods + 1)) {\n return $fCostDelta - $fOneRate * $nNumOfFullPeriods - $f0Rate;\n }\n\n return 0.0;\n }\n\n private static function getAmortizationCoefficient(float $rate): float\n {\n // The depreciation coefficients are:\n // Life of assets (1/rate) Depreciation coefficient\n // Less than 3 years 1\n // Between 3 and 4 years 1.5\n // Between 5 and 6 years 2\n // More than 6 years 2.5\n $fUsePer = 1.0 / $rate;\n\n if ($fUsePer < 3.0) {\n return 1.0;\n } elseif ($fUsePer < 4.0) {\n return 1.5;\n } elseif ($fUsePer <= 6.0) {\n return 2.0;\n }\n\n return 2.5;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Financial/CashFlow/CashFlowValidations.php",
"content": "getMessage();\n }\n\n // Validate parameters\n if ($start < 1 || $start > $end) {\n return ExcelError::NAN();\n }\n\n // Calculate\n $interest = 0;\n for ($per = $start; $per <= $end; ++$per) {\n $ipmt = Interest::payment($rate, $per, $periods, $presentValue, 0, $type);\n if (is_string($ipmt)) {\n return $ipmt;\n }\n\n $interest += $ipmt;\n }\n\n return $interest;\n }\n\n /**\n * CUMPRINC.\n *\n * Returns the cumulative principal paid on a loan between the start and end periods.\n *\n * Excel Function:\n * CUMPRINC(rate,nper,pv,start,end[,type])\n *\n * @param mixed $rate The Interest rate\n * @param mixed $periods The total number of payment periods as an integer\n * @param mixed $presentValue Present Value\n * @param mixed $start The first period in the calculation.\n * Payment periods are numbered beginning with 1.\n * @param mixed $end the last period in the calculation\n * @param mixed $type A number 0 or 1 and indicates when payments are due:\n * 0 or omitted At the end of the period.\n * 1 At the beginning of the period.\n */\n public static function principal(\n mixed $rate,\n mixed $periods,\n mixed $presentValue,\n mixed $start,\n mixed $end,\n mixed $type = FinancialConstants::PAYMENT_END_OF_PERIOD\n ): string|float|int {\n $rate = Functions::flattenSingleValue($rate);\n $periods = Functions::flattenSingleValue($periods);\n $presentValue = Functions::flattenSingleValue($presentValue);\n $start = Functions::flattenSingleValue($start);\n $end = Functions::flattenSingleValue($end);\n $type = Functions::flattenSingleValue($type) ?? FinancialConstants::PAYMENT_END_OF_PERIOD;\n\n try {\n $rate = CashFlowValidations::validateRate($rate);\n $periods = CashFlowValidations::validateInt($periods);\n $presentValue = CashFlowValidations::validatePresentValue($presentValue);\n $start = CashFlowValidations::validateInt($start);\n $end = CashFlowValidations::validateInt($end);\n $type = CashFlowValidations::validatePeriodType($type);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n // Validate parameters\n if ($start < 1 || $start > $end) {\n return ExcelError::VALUE();\n }\n\n // Calculate\n $principal = 0;\n for ($per = $start; $per <= $end; ++$per) {\n $ppmt = Payments::interestPayment($rate, $per, $periods, $presentValue, 0, $type);\n if (is_string($ppmt)) {\n return $ppmt;\n }\n\n $principal += $ppmt;\n }\n\n return $principal;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic/Interest.php",
"content": "getMessage();\n }\n\n // Validate parameters\n if ($period <= 0 || $period > $numberOfPeriods) {\n return ExcelError::NAN();\n }\n\n // Calculate\n $interestAndPrincipal = new InterestAndPrincipal(\n $interestRate,\n $period,\n $numberOfPeriods,\n $presentValue,\n $futureValue,\n $type\n );\n\n return $interestAndPrincipal->interest();\n }\n\n /**\n * ISPMT.\n *\n * Returns the interest payment for an investment based on an interest rate and a constant payment schedule.\n *\n * Excel Function:\n * =ISPMT(interest_rate, period, number_payments, pv)\n *\n * @param mixed $interestRate is the interest rate for the investment\n * @param mixed $period is the period to calculate the interest rate. It must be between 1 and number_payments.\n * @param mixed $numberOfPeriods is the number of payments for the annuity\n * @param mixed $principleRemaining is the loan amount or present value of the payments\n */\n public static function schedulePayment(mixed $interestRate, mixed $period, mixed $numberOfPeriods, mixed $principleRemaining): string|float\n {\n $interestRate = Functions::flattenSingleValue($interestRate);\n $period = Functions::flattenSingleValue($period);\n $numberOfPeriods = Functions::flattenSingleValue($numberOfPeriods);\n $principleRemaining = Functions::flattenSingleValue($principleRemaining);\n\n try {\n $interestRate = CashFlowValidations::validateRate($interestRate);\n $period = CashFlowValidations::validateInt($period);\n $numberOfPeriods = CashFlowValidations::validateInt($numberOfPeriods);\n $principleRemaining = CashFlowValidations::validateFloat($principleRemaining);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n // Validate parameters\n if ($period <= 0 || $period > $numberOfPeriods) {\n return ExcelError::NAN();\n }\n\n // Return value\n $returnValue = 0;\n\n // Calculate\n $principlePayment = ($principleRemaining * 1.0) / ($numberOfPeriods * 1.0);\n for ($i = 0; $i <= $period; ++$i) {\n $returnValue = $interestRate * $principleRemaining * -1;\n $principleRemaining -= $principlePayment;\n // principle needs to be 0 after the last payment, don't let floating point screw it up\n if ($i == $numberOfPeriods) {\n $returnValue = 0.0;\n }\n }\n\n return $returnValue;\n }\n\n /**\n * RATE.\n *\n * Returns the interest rate per period of an annuity.\n * RATE is calculated by iteration and can have zero or more solutions.\n * If the successive results of RATE do not converge to within 0.0000001 after 20 iterations,\n * RATE returns the #NUM! error value.\n *\n * Excel Function:\n * RATE(nper,pmt,pv[,fv[,type[,guess]]])\n *\n * @param mixed $numberOfPeriods The total number of payment periods in an annuity\n * @param mixed $payment The payment made each period and cannot change over the life of the annuity.\n * Typically, pmt includes principal and interest but no other fees or taxes.\n * @param mixed $presentValue The present value - the total amount that a series of future payments is worth now\n * @param mixed $futureValue The future value, or a cash balance you want to attain after the last payment is made.\n * If fv is omitted, it is assumed to be 0 (the future value of a loan,\n * for example, is 0).\n * @param mixed $type A number 0 or 1 and indicates when payments are due:\n * 0 or omitted At the end of the period.\n * 1 At the beginning of the period.\n * @param mixed $guess Your guess for what the rate will be.\n * If you omit guess, it is assumed to be 10 percent.\n */\n public static function rate(\n mixed $numberOfPeriods,\n mixed $payment,\n mixed $presentValue,\n mixed $futureValue = 0.0,\n mixed $type = FinancialConstants::PAYMENT_END_OF_PERIOD,\n mixed $guess = 0.1\n ): string|float {\n $numberOfPeriods = Functions::flattenSingleValue($numberOfPeriods);\n $payment = Functions::flattenSingleValue($payment);\n $presentValue = Functions::flattenSingleValue($presentValue);\n $futureValue = Functions::flattenSingleValue($futureValue) ?? 0.0;\n $type = Functions::flattenSingleValue($type) ?? FinancialConstants::PAYMENT_END_OF_PERIOD;\n $guess = Functions::flattenSingleValue($guess) ?? 0.1;\n\n try {\n $numberOfPeriods = CashFlowValidations::validateFloat($numberOfPeriods);\n $payment = CashFlowValidations::validateFloat($payment);\n $presentValue = CashFlowValidations::validatePresentValue($presentValue);\n $futureValue = CashFlowValidations::validateFutureValue($futureValue);\n $type = CashFlowValidations::validatePeriodType($type);\n $guess = CashFlowValidations::validateFloat($guess);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n $rate = $guess;\n // rest of code adapted from python/numpy\n $close = false;\n $iter = 0;\n while (!$close && $iter < self::FINANCIAL_MAX_ITERATIONS) {\n $nextdiff = self::rateNextGuess($rate, $numberOfPeriods, $payment, $presentValue, $futureValue, $type);\n if (!is_numeric($nextdiff)) {\n break;\n }\n $rate1 = $rate - $nextdiff;\n $close = abs($rate1 - $rate) < self::FINANCIAL_PRECISION;\n ++$iter;\n $rate = $rate1;\n }\n\n return $close ? $rate : ExcelError::NAN();\n }\n\n private static function rateNextGuess(float $rate, float $numberOfPeriods, float $payment, float $presentValue, float $futureValue, int $type): string|float\n {\n if ($rate == 0.0) {\n return ExcelError::NAN();\n }\n $tt1 = ($rate + 1) ** $numberOfPeriods;\n $tt2 = ($rate + 1) ** ($numberOfPeriods - 1);\n $numerator = $futureValue + $tt1 * $presentValue + $payment * ($tt1 - 1) * ($rate * $type + 1) / $rate;\n $denominator = $numberOfPeriods * $tt2 * $presentValue - $payment * ($tt1 - 1)\n * ($rate * $type + 1) / ($rate * $rate) + $numberOfPeriods\n * $payment * $tt2 * ($rate * $type + 1) / $rate + $payment * ($tt1 - 1) * $type / $rate;\n if ($denominator == 0) {\n return ExcelError::NAN();\n }\n\n return $numerator / $denominator;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic/InterestAndPrincipal.php",
"content": "interest = $interest;\n $this->principal = $principal;\n }\n\n public function interest(): float\n {\n return $this->interest;\n }\n\n public function principal(): float\n {\n return $this->principal;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic/Payments.php",
"content": "getMessage();\n }\n\n // Calculate\n if ($interestRate != 0.0) {\n return (-$futureValue - $presentValue * (1 + $interestRate) ** $numberOfPeriods)\n / (1 + $interestRate * $type) / (((1 + $interestRate) ** $numberOfPeriods - 1) / $interestRate);\n }\n\n return (-$presentValue - $futureValue) / $numberOfPeriods;\n }\n\n /**\n * PPMT.\n *\n * Returns the interest payment for a given period for an investment based on periodic, constant payments\n * and a constant interest rate.\n *\n * @param mixed $interestRate Interest rate per period\n * @param mixed $period Period for which we want to find the interest\n * @param mixed $numberOfPeriods Number of periods\n * @param mixed $presentValue Present Value\n * @param mixed $futureValue Future Value\n * @param mixed $type Payment type: 0 = at the end of each period, 1 = at the beginning of each period\n *\n * @return float|string Result, or a string containing an error\n */\n public static function interestPayment(\n mixed $interestRate,\n mixed $period,\n mixed $numberOfPeriods,\n mixed $presentValue,\n mixed $futureValue = 0,\n mixed $type = FinancialConstants::PAYMENT_END_OF_PERIOD\n ): string|float {\n $interestRate = Functions::flattenSingleValue($interestRate);\n $period = Functions::flattenSingleValue($period);\n $numberOfPeriods = Functions::flattenSingleValue($numberOfPeriods);\n $presentValue = Functions::flattenSingleValue($presentValue);\n $futureValue = ($futureValue === null) ? 0.0 : Functions::flattenSingleValue($futureValue);\n $type = Functions::flattenSingleValue($type) ?? FinancialConstants::PAYMENT_END_OF_PERIOD;\n\n try {\n $interestRate = CashFlowValidations::validateRate($interestRate);\n $period = CashFlowValidations::validateInt($period);\n $numberOfPeriods = CashFlowValidations::validateInt($numberOfPeriods);\n $presentValue = CashFlowValidations::validatePresentValue($presentValue);\n $futureValue = CashFlowValidations::validateFutureValue($futureValue);\n $type = CashFlowValidations::validatePeriodType($type);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n // Validate parameters\n if ($period <= 0 || $period > $numberOfPeriods) {\n return ExcelError::NAN();\n }\n\n // Calculate\n $interestAndPrincipal = new InterestAndPrincipal(\n $interestRate,\n $period,\n $numberOfPeriods,\n $presentValue,\n $futureValue,\n $type\n );\n\n return $interestAndPrincipal->principal();\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic.php",
"content": "getMessage();\n }\n\n return self::calculateFutureValue($rate, $numberOfPeriods, $payment, $presentValue, $type);\n }\n\n /**\n * PV.\n *\n * Returns the Present Value of a cash flow with constant payments and interest rate (annuities).\n *\n * @param mixed $rate Interest rate per period\n * @param mixed $numberOfPeriods Number of periods as an integer\n * @param mixed $payment Periodic payment (annuity)\n * @param mixed $futureValue Future Value\n * @param mixed $type Payment type: 0 = at the end of each period, 1 = at the beginning of each period\n *\n * @return float|string Result, or a string containing an error\n */\n public static function presentValue(\n mixed $rate,\n mixed $numberOfPeriods,\n mixed $payment = 0.0,\n mixed $futureValue = 0.0,\n mixed $type = FinancialConstants::PAYMENT_END_OF_PERIOD\n ): string|float {\n $rate = Functions::flattenSingleValue($rate);\n $numberOfPeriods = Functions::flattenSingleValue($numberOfPeriods);\n $payment = Functions::flattenSingleValue($payment) ?? 0.0;\n $futureValue = Functions::flattenSingleValue($futureValue) ?? 0.0;\n $type = Functions::flattenSingleValue($type) ?? FinancialConstants::PAYMENT_END_OF_PERIOD;\n\n try {\n $rate = CashFlowValidations::validateRate($rate);\n $numberOfPeriods = CashFlowValidations::validateInt($numberOfPeriods);\n $payment = CashFlowValidations::validateFloat($payment);\n $futureValue = CashFlowValidations::validateFutureValue($futureValue);\n $type = CashFlowValidations::validatePeriodType($type);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n // Validate parameters\n if ($numberOfPeriods < 0) {\n return ExcelError::NAN();\n }\n\n return self::calculatePresentValue($rate, $numberOfPeriods, $payment, $futureValue, $type);\n }\n\n /**\n * NPER.\n *\n * Returns the number of periods for a cash flow with constant periodic payments (annuities), and interest rate.\n *\n * @param mixed $rate Interest rate per period\n * @param mixed $payment Periodic payment (annuity)\n * @param mixed $presentValue Present Value\n * @param mixed $futureValue Future Value\n * @param mixed $type Payment type: 0 = at the end of each period, 1 = at the beginning of each period\n *\n * @return float|string Result, or a string containing an error\n */\n public static function periods(\n mixed $rate,\n mixed $payment,\n mixed $presentValue,\n mixed $futureValue = 0.0,\n mixed $type = FinancialConstants::PAYMENT_END_OF_PERIOD\n ) {\n $rate = Functions::flattenSingleValue($rate);\n $payment = Functions::flattenSingleValue($payment);\n $presentValue = Functions::flattenSingleValue($presentValue);\n $futureValue = Functions::flattenSingleValue($futureValue) ?? 0.0;\n $type = Functions::flattenSingleValue($type) ?? FinancialConstants::PAYMENT_END_OF_PERIOD;\n\n try {\n $rate = CashFlowValidations::validateRate($rate);\n $payment = CashFlowValidations::validateFloat($payment);\n $presentValue = CashFlowValidations::validatePresentValue($presentValue);\n $futureValue = CashFlowValidations::validateFutureValue($futureValue);\n $type = CashFlowValidations::validatePeriodType($type);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n // Validate parameters\n if ($payment == 0.0) {\n return ExcelError::NAN();\n }\n\n return self::calculatePeriods($rate, $payment, $presentValue, $futureValue, $type);\n }\n\n private static function calculateFutureValue(\n float $rate,\n int $numberOfPeriods,\n float $payment,\n float $presentValue,\n int $type\n ): float {\n if ($rate != 0) {\n return -$presentValue\n * (1 + $rate) ** $numberOfPeriods - $payment * (1 + $rate * $type) * ((1 + $rate) ** $numberOfPeriods - 1)\n / $rate;\n }\n\n return -$presentValue - $payment * $numberOfPeriods;\n }\n\n private static function calculatePresentValue(\n float $rate,\n int $numberOfPeriods,\n float $payment,\n float $futureValue,\n int $type\n ): float {\n if ($rate != 0.0) {\n return (-$payment * (1 + $rate * $type)\n * (((1 + $rate) ** $numberOfPeriods - 1) / $rate) - $futureValue) / (1 + $rate) ** $numberOfPeriods;\n }\n\n return -$futureValue - $payment * $numberOfPeriods;\n }\n\n private static function calculatePeriods(\n float $rate,\n float $payment,\n float $presentValue,\n float $futureValue,\n int $type\n ): string|float {\n if ($rate != 0.0) {\n if ($presentValue == 0.0) {\n return ExcelError::NAN();\n }\n\n return log(($payment * (1 + $rate * $type) / $rate - $futureValue)\n / ($presentValue + $payment * (1 + $rate * $type) / $rate)) / log(1 + $rate);\n }\n\n return (-$presentValue - $futureValue) / $payment;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Financial/CashFlow/Single.php",
"content": "getMessage();\n }\n\n return $principal;\n }\n\n /**\n * PDURATION.\n *\n * Calculates the number of periods required for an investment to reach a specified value.\n *\n * @param mixed $rate Interest rate per period\n * @param mixed $presentValue Present Value\n * @param mixed $futureValue Future Value\n *\n * @return float|string Result, or a string containing an error\n */\n public static function periods(mixed $rate, mixed $presentValue, mixed $futureValue): string|float\n {\n $rate = Functions::flattenSingleValue($rate);\n $presentValue = Functions::flattenSingleValue($presentValue);\n $futureValue = Functions::flattenSingleValue($futureValue);\n\n try {\n $rate = CashFlowValidations::validateRate($rate);\n $presentValue = CashFlowValidations::validatePresentValue($presentValue);\n $futureValue = CashFlowValidations::validateFutureValue($futureValue);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n // Validate parameters\n if ($rate <= 0.0 || $presentValue <= 0.0 || $futureValue <= 0.0) {\n return ExcelError::NAN();\n }\n\n return (log($futureValue) - log($presentValue)) / log(1 + $rate);\n }\n\n /**\n * RRI.\n *\n * Calculates the interest rate required for an investment to grow to a specified future value .\n *\n * @param mixed $periods The number of periods over which the investment is made, expect array|float\n * @param mixed $presentValue Present Value, expect array|float\n * @param mixed $futureValue Future Value, expect array|float\n *\n * @return float|string Result, or a string containing an error\n */\n public static function interestRate(mixed $periods = 0.0, mixed $presentValue = 0.0, mixed $futureValue = 0.0): string|float\n {\n $periods = Functions::flattenSingleValue($periods);\n $presentValue = Functions::flattenSingleValue($presentValue);\n $futureValue = Functions::flattenSingleValue($futureValue);\n\n try {\n $periods = CashFlowValidations::validateFloat($periods);\n $presentValue = CashFlowValidations::validatePresentValue($presentValue);\n $futureValue = CashFlowValidations::validateFutureValue($futureValue);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n\n // Validate parameters\n if ($periods <= 0.0 || $presentValue <= 0.0 || $futureValue < 0.0) {\n return ExcelError::NAN();\n }\n\n return ($futureValue / $presentValue) ** (1 / $periods) - 1;\n }\n}\n"
},
{
"path": "src/PhpSpreadsheet/Calculation/Financial/CashFlow/Variable/NonPeriodic.php",
"content": " $values A series of cash flow payments, expecting float[]\n * The series of values must contain at least one positive value & one negative value\n * @param array $dates A series of payment dates\n * The first payment date indicates the beginning of the schedule of payments\n * All other dates must be later than this date, but they may occur in any order\n * @param mixed $guess An optional guess at the expected answer\n */\n public static function rate(mixed $values, $dates, mixed $guess = self::DEFAULT_GUESS): float|string\n {\n $rslt = self::xirrPart1($values, $dates);\n /** @var array $dates */\n if ($rslt !== '') {\n return $rslt;\n }\n\n // create an initial range, with a root somewhere between 0 and guess\n $guess = Functions::flattenSingleValue($guess) ?? self::DEFAULT_GUESS;\n if (!is_numeric($guess)) {\n return ExcelError::VALUE();\n }\n $guess = ($guess + 0.0) ?: self::DEFAULT_GUESS;\n $x1 = 0.0;\n $x2 = $guess + 0.0;\n $f1 = self::xnpvOrdered($x1, $values, $dates, false);\n $f2 = self::xnpvOrdered($x2, $values, $dates, false);\n $found = false;\n for ($i = 0; $i < self::FINANCIAL_MAX_ITERATIONS; ++$i) {\n if (!is_numeric($f1)) {\n return $f1;\n }\n if (!is_numeric($f2)) {\n return $f2;\n }\n $f1 = (float) $f1;\n $f2 = (float) $f2;\n if (($f1 * $f2) < 0.0) {\n $found = true;\n\n break;\n } elseif (abs($f1) < abs($f2)) {\n $x1 += 1.6 * ($x1 - $x2);\n $f1 = self::xnpvOrdered($x1, $values, $dates, false);\n } else {\n $x2 += 1.6 * ($x2 - $x1);\n $f2 = self::xnpvOrdered($x2, $values, $dates, false);\n }\n }\n if ($found) {\n return self::xirrPart3($values, $dates, $x1, $x2);\n }\n\n // Newton-Raphson didn't work - try bisection\n $x1 = $guess - 0.5;\n $x2 = $guess + 0.5;\n for ($i = 0; $i < self::FINANCIAL_MAX_ITERATIONS; ++$i) {\n $f1 = self::xnpvOrdered($x1, $values, $dates, false, true);\n $f2 = self::xnpvOrdered($x2, $values, $dates, false, true);\n if (!is_numeric($f1) || !is_numeric($f2)) {\n break;\n }\n if ($f1 * $f2 <= 0) {\n $found = true;\n\n break;\n }\n $x1 -= 0.5;\n $x2 += 0.5;\n }\n if ($found) {\n /** @var array $dates */\n return self::xirrBisection($values, $dates, $x1, $x2);\n }\n\n return ExcelError::NAN();\n }\n\n /**\n * XNPV.\n *\n * Returns the net present value for a schedule of cash flows that is not necessarily periodic.\n * To calculate the net present value for a series of cash flows that is periodic, use the NPV function.\n *\n * Excel Function:\n * =XNPV(rate,values,dates)\n *\n * @param mixed $rate the discount rate to apply to the cash flows, expect array|float\n * @param array $values A series of cash flows that corresponds to a schedule of payments in dates, expecting float[].\n * The first payment is optional and corresponds to a cost or payment that occurs\n * at the beginning of the investment.\n * If the first value is a cost or payment, it must be a negative value.\n * All succeeding payments are discounted based on a 365-day year.\n * The series of values must contain at least one positive value and one negative value.\n * @param mixed $dates A schedule of payment dates that corresponds to the cash flow payments, expecting mixed[].\n * The first payment date indicates the beginning of the schedule of payments.\n * All other dates must be later than this date, but they may occur in any order.\n */\n public static function presentValue(mixed $rate, mixed $values, mixed $dates): float|string\n {\n return self::xnpvOrdered($rate, $values, $dates, true);\n }\n\n private static function bothNegAndPos(bool $neg, bool $pos): bool\n {\n return $neg && $pos;\n }\n\n /** @param array $values */\n private static function xirrPart1(mixed &$values, mixed &$dates): string\n {\n /** @var array */\n $temp = Functions::flattenArray($values);\n $values = $temp;\n $dates = Functions::flattenArray($dates);\n $valuesIsArray = count($values) > 1;\n $datesIsArray = count($dates) > 1;\n if (!$valuesIsArray && !$datesIsArray) {\n return ExcelError::NA();\n }\n if (count($values) != count($dates)) {\n return ExcelError::NAN();\n }\n\n $datesCount = count($dates);\n for ($i = 0; $i < $datesCount; ++$i) {\n try {\n $dates[$i] = DateTimeExcel\\Helpers::getDateValue($dates[$i]);\n } catch (Exception $e) {\n return $e->getMessage();\n }\n }\n\n return self::xirrPart2($values);\n }\n\n /** @param array $values */\n private static function xirrPart2(array &$values): string\n {\n $valCount = count($values);\n $foundpos = false;\n $foundneg = false;\n for ($i = 0; $i < $valCount; ++$i) {\n $fld = $values[$i];\n if (!is_numeric($fld)) { //* @phpstan-ignore-line\n return ExcelError::VALUE();\n } elseif ($fld > 0) {\n $foundpos = true;\n } elseif ($fld < 0) {\n $foundneg = true;\n }\n }\n if (!self::bothNegAndPos($foundneg, $foundpos)) {\n return ExcelError::NAN();\n }\n\n return '';\n }\n\n /**\n * @param array
' . 'samples/templates/' . $inputFileName . '');\n$helper->log('Read ' . $codePath . ' with conditional formatting');\n$reader = IOFactory::createReader('Xlsx');\n$reader->setReadDataOnly(false);\n$spreadsheet = $reader->load($inputFilePath);\n$helper->log('Enable conditional formatting output');\n\nfunction writerCallback(HtmlWriter $writer): void\n{\n $writer->setPreCalculateFormulas(true);\n $writer->setConditionalFormatting(true);\n}\n\n// Save\n$helper->write($spreadsheet, __FILE__, ['Html'], false, writerCallback: writerCallback(...));\n"
},
{
"path": "samples/Html/html_02_More_Conditional_Formatting.php",
"content": "isCli() ? ('samples/templates/' . $inputFileName) : ('' . 'samples/templates/' . $inputFileName . '');\n$helper->log('Read ' . $codePath . ' with conditional formatting');\n$reader = IOFactory::createReader('Xlsx');\n$reader->setReadDataOnly(false);\n$spreadsheet = $reader->load($inputFilePath);\n$helper->log('Enable conditional formatting output');\n\nfunction writerCallback(HtmlWriter $writer): void\n{\n $writer->setPreCalculateFormulas(true);\n $writer->setConditionalFormatting(true);\n}\n\n// Save\n$helper->write($spreadsheet, __FILE__, ['Html'], false, writerCallback: writerCallback(...));\n"
},
{
"path": "samples/Html/html_03_Color_Scale.php",
"content": "isCli() ? ('samples/templates/' . $inputFileName) : ('' . 'samples/templates/' . $inputFileName . '');\n$helper->log('Read ' . $codePath . ' with color scale');\n$reader = IOFactory::createReader('Xlsx');\n$reader->setReadDataOnly(false);\n$spreadsheet = $reader->load($inputFilePath);\n$helper->log('Enable conditional formatting output');\n\nfunction writerCallback(HtmlWriter $writer): void\n{\n $writer->setPreCalculateFormulas(true);\n $writer->setConditionalFormatting(true);\n}\n\n// Save\n$helper->write($spreadsheet, __FILE__, ['Html'], false, writerCallback: writerCallback(...));\n"
},
{
"path": "samples/Html/html_04_Table_Format_without_Conditional.php",
"content": "isCli() ? ('samples/templates/' . $inputFileName) : ('' . 'samples/templates/' . $inputFileName . '');\n$helper->log('Read ' . $codePath);\n$reader = IOFactory::createReader('Xlsx');\n$reader->setReadDataOnly(false);\n$spreadsheet = $reader->load($inputFilePath);\n$helper->log('Enable table formatting output');\n\nfunction writerCallback(HtmlWriter $writer): void\n{\n $writer->setPreCalculateFormulas(true);\n $writer->setTableFormats(true);\n}\n\n// Save\n$helper->write($spreadsheet, __FILE__, ['Html'], false, writerCallback: writerCallback(...));\n"
},
{
"path": "samples/Html/html_05_Table_Format_with_Conditional.php",
"content": "isCli() ? ('samples/templates/' . $inputFileName) : ('' . 'samples/templates/' . $inputFileName . '');\n$helper->log('Read ' . $codePath);\n$reader = IOFactory::createReader('Xlsx');\n$reader->setReadDataOnly(false);\n$spreadsheet = $reader->load($inputFilePath);\n$helper->log('Enable table formatting output');\n$helper->log('Enable conditional formatting output');\n\nfunction writerCallback(HtmlWriter $writer): void\n{\n $writer->setPreCalculateFormulas(true);\n $writer->setTableFormats(true);\n $writer->setConditionalFormatting(true);\n}\n\n// Save\n$helper->write($spreadsheet, __FILE__, ['Html'], false, writerCallback: writerCallback(...));\n"
},
{
"path": "samples/Html/html_06_Table_Cellspacing.php",
"content": "log('Emulate table border, cellspacing, cellpadding attributes');\n\nfunction addCellspacing(string $html): string\n{\n return str_replace(\n 'table { border-collapse:collapse }',\n 'table { border-collapse:separate; border-spacing: 5px; }'\n . \"\\ntable.sheet0 {border: 1px solid red}\"\n . \"\\ntd, th {padding: 3px}\",\n $html\n );\n}\n\nfunction writerCallback(HtmlWriter $writer): void\n{\n $writer->setLineEnding(\"\\n\")\n ->writeAllSheets()\n ->setEditHtmlCallback(addCellspacing(...));\n}\n\n$spreadsheet = new Spreadsheet();\n$helper->log('Sheet1 will have no borders inside, red border outside from callback');\n$sheet1 = $spreadsheet->getActiveSheet();\n$sheet1->setTitle('Sheet1');\n$sheet1->setShowGridlines(false);\n$sheet1->setPrintGridlines(false);\n$sheet1->fromArray([\n [11, 12, 13],\n [14, 15, 16],\n]);\n$helper->log('Sheet2 will have no borders (display), separate borders (print) from callback');\n$sheet2 = $spreadsheet->createSheet();\n$sheet2->setTitle('Sheet2');\n$sheet2->setShowGridlines(false);\n$sheet2->setPrintGridlines(true);\n$sheet2->fromArray([\n [21, 22, 23],\n [24, 25, 26],\n]);\n$helper->log('Sheet3 will have no borders (print), separate borders (display) from callback');\n$sheet3 = $spreadsheet->createSheet();\n$sheet3->setTitle('Sheet3');\n$sheet3->setShowGridlines(true);\n$sheet3->setPrintGridlines(false);\n$sheet3->fromArray([\n [31, 32, 33],\n [34, 35, 36],\n]);\n$helper->log('Sheet4 will have separate borders (print and display) from callback');\n$sheet4 = $spreadsheet->createSheet();\n$sheet4->setTitle('Sheet4');\n$sheet4->setShowGridlines(true);\n$sheet4->setPrintGridlines(true);\n$sheet4->fromArray([\n [41, 42, 43],\n [44, 45, 46],\n]);\n\n$helper->log('Auto-size column dimensions');\nforeach ([$sheet1, $sheet2, $sheet3, $sheet4] as $sheet) {\n $sheet->getColumnDimension('A')->setAutoSize(true);\n $sheet->getColumnDimension('B')->setAutoSize(true);\n $sheet->getColumnDimension('C')->setAutoSize(true);\n}\n\n// Save\n$helper->write($spreadsheet, __FILE__, ['Html'], false, writerCallback: writerCallback(...));\n"
},
{
"path": "samples/LookupRef/ADDRESS.php",
"content": "log('Returns a text reference to a single cell in a worksheet.');\n\n// Create new PhpSpreadsheet object\n$spreadsheet = new Spreadsheet();\n$worksheet = $spreadsheet->getActiveSheet();\n\n$worksheet->getCell('A1')->setValue('=ADDRESS(2,3)');\n$worksheet->getCell('A2')->setValue('=ADDRESS(2,3,2)');\n$worksheet->getCell('A3')->setValue('=ADDRESS(2,3,2,FALSE)');\n$worksheet->getCell('A4')->setValue('=ADDRESS(2,3,1,FALSE,\"[Book1.xlsx]Sheet1\")');\n$worksheet->getCell('A5')->setValue('=ADDRESS(2,3,1,FALSE,\"EXCEL SHEET\")');\n\nfor ($row = 1; $row <= 5; ++$row) {\n $cell = $worksheet->getCell(\"A{$row}\");\n $helper->log(\"A{$row}: \" . $cell->getValueString() . ' => ' . $cell->getCalculatedValueString());\n}\n"
},
{
"path": "samples/LookupRef/COLUMN.php",
"content": "log('Returns the column index of a cell.');\n\n// Create new PhpSpreadsheet object\n$spreadsheet = new Spreadsheet();\n$calculation = Calculation::getInstance($spreadsheet);\n$calculation->setInstanceArrayReturnType(\n Calculation::RETURN_ARRAY_AS_VALUE\n);\n$worksheet = $spreadsheet->getActiveSheet();\n\n$worksheet->getCell('A1')->setValue('=COLUMN(C13)');\n$worksheet->getCell('A2')->setValue('=COLUMN(E13:G15)');\n$worksheet->getCell('F1')->setValue('=COLUMN()');\n\nfor ($row = 1; $row <= 2; ++$row) {\n $cell = $worksheet->getCell(\"A{$row}\");\n $helper->log(\"A{$row}: \" . $cell->getValueString() . ' => ' . $cell->getCalculatedValueString());\n}\n\n$cell = $worksheet->getCell('F1');\n$helper->log('F1: ' . $cell->getValueString() . ' => ' . $cell->getCalculatedValueString());\n"
},
{
"path": "samples/LookupRef/COLUMNS.php",
"content": "log('Returns the number of columns in an array or reference.');\n\n// Create new PhpSpreadsheet object\n$spreadsheet = new Spreadsheet();\n$worksheet = $spreadsheet->getActiveSheet();\n\n$worksheet->getCell('A1')->setValue('=COLUMNS(C1:G4)');\n$worksheet->getCell('A2')->setValue('=COLUMNS({1,2,3;4,5,6})');\n$worksheet->getCell('A3')->setValue('=ROWS(C1:E4 D3:G5)');\n$worksheet->getCell('A4')->setValue('=COLUMNS(1:1)');\n\nfor ($row = 1; $row <= 4; ++$row) {\n $cell = $worksheet->getCell(\"A{$row}\");\n $helper->log(\"A{$row}: \" . $cell->getValueString() . ' => ' . $cell->getCalculatedValueString());\n}\n"
},
{
"path": "samples/LookupRef/INDEX.php",
"content": "log('Returns the row index of a cell.');\n\n// Create new PhpSpreadsheet object\n$spreadsheet = new Spreadsheet();\n$worksheet = $spreadsheet->getActiveSheet();\n\n$data1 = [\n ['Apples', 'Lemons'],\n ['Bananas', 'Pears'],\n];\n\n$data2 = [\n [4, 6],\n [5, 3],\n [6, 9],\n [7, 5],\n [8, 3],\n];\n\n$worksheet->fromArray($data1, null, 'A1');\n$worksheet->fromArray($data2, null, 'C1');\n\n$worksheet->getCell('A11')->setValue('=INDEX(A1:B2, 2, 2)');\n$worksheet->getCell('A12')->setValue('=INDEX(A1:B2, 2, 1)');\n$worksheet->getCell('A13')->setValue('=INDEX({1,2;3,4}, 0, 2)');\n$worksheet->getCell('A14')->setValue('=INDEX(C1:C5, 5)');\n$worksheet->getCell('A15')->setValue('=INDEX(C1:D5, 5, 2)');\n$worksheet->getCell('A16')->setValue('=SUM(INDEX(C1:D5, 5, 0))');\n\nfor ($row = 11; $row <= 16; ++$row) {\n $cell = $worksheet->getCell(\"A{$row}\");\n $helper->log(\"A{$row}: \" . $cell->getValueString() . ' => ' . $cell->getCalculatedValueString());\n}\n"
},
{
"path": "samples/LookupRef/INDIRECT.php",
"content": "log('Returns the cell specified by a text string.');\n\n// Create new PhpSpreadsheet object\n$spreadsheet = new Spreadsheet();\n$worksheet = $spreadsheet->getActiveSheet();\n\n$data = [\n [8, 9, 0],\n [3, 4, 5],\n [9, 1, 3],\n [4, 6, 2],\n];\n$worksheet->fromArray($data, null, 'C1');\n\n$spreadsheet->addNamedRange(new NamedRange('NAMED_RANGE_FOR_CELL_D4', $worksheet, '=\"$D$4\"'));\n\n$worksheet->getCell('A1')->setValue('=INDIRECT(\"C1\")');\n$worksheet->getCell('A2')->setValue('=INDIRECT(\"D\"&4)');\n$worksheet->getCell('A3')->setValue('=INDIRECT(\"E\"&ROW())');\n$worksheet->getCell('A4')->setValue('=SUM(INDIRECT(\"$C$4:$E$4\"))');\n$worksheet->getCell('A5')->setValue('=INDIRECT(NAMED_RANGE_FOR_CELL_D4)');\n\nfor ($row = 1; $row <= 5; ++$row) {\n $cell = $worksheet->getCell(\"A{$row}\");\n $helper->log(\"A{$row}: \" . $cell->getValueString() . ' => ' . $cell->getCalculatedValueString());\n}\n"
},
{
"path": "samples/LookupRef/OFFSET.php",
"content": "log('Returns a cell range that is a specified number of rows and columns from a cell or range of cells.');\n\n// Create new PhpSpreadsheet object\n$spreadsheet = new Spreadsheet();\n$worksheet = $spreadsheet->getActiveSheet();\n\n$data = [\n [null, 'Week 1', 'Week 2', 'Week 3', 'Week 4'],\n ['Sunday', 4500, 2200, 3800, 1500],\n ['Monday', 5500, 6100, 5200, 4800],\n ['Tuesday', 7000, 6200, 5000, 7100],\n ['Wednesday', 8000, 4000, 3900, 7600],\n ['Thursday', 5900, 5500, 6900, 7100],\n ['Friday', 4900, 6300, 6900, 5200],\n ['Saturday', 3500, 3900, 5100, 4100],\n];\n$worksheet->fromArray($data, null, 'A3');\n\n$worksheet->getCell('H1')->setValue('=OFFSET(A3, 3, 1)');\n$worksheet->getCell('H2')->setValue('=SUM(OFFSET(A3, 3, 1, 1, 4))');\n$worksheet->getCell('H3')->setValue('=SUM(OFFSET(B3:E3, 3, 0))');\n$worksheet->getCell('H4')->setValue('=SUM(OFFSET(E3, 1, -3, 7))');\n\nfor ($row = 1; $row <= 4; ++$row) {\n $cell = $worksheet->getCell(\"H{$row}\");\n $helper->log(\"H{$row}: \" . $cell->getValueString() . ' => ' . $cell->getCalculatedValueString());\n}\n"
},
{
"path": "samples/LookupRef/ROW.php",
"content": "log('Returns the row index of a cell.');\n\n// Create new PhpSpreadsheet object\n$spreadsheet = new Spreadsheet();\n$worksheet = $spreadsheet->getActiveSheet();\n\n$worksheet->getCell('A1')->setValue('=ROW(C13)');\n$worksheet->getCell('A2')->setValue('=ROW(E19:G21)');\n$worksheet->getCell('A3')->setValue('=ROW()');\n\nfor ($row = 1; $row <= 3; ++$row) {\n $cell = $worksheet->getCell(\"A{$row}\");\n $helper->log(\"A{$row}: \" . $cell->getValueString() . ' => ' . $cell->getCalculatedValueString());\n}\n"
},
{
"path": "samples/LookupRef/ROWS.php",
"content": "log('Returns the row index of a cell.');\n\n// Create new PhpSpreadsheet object\n$spreadsheet = new Spreadsheet();\n$worksheet = $spreadsheet->getActiveSheet();\n\n$worksheet->getCell('A1')->setValue('=ROWS(C1:E4)');\n$worksheet->getCell('A2')->setValue('=ROWS({1,2,3;4,5,6})');\n$worksheet->getCell('A3')->setValue('=ROWS(C1:E4 D3:G5)');\n\nfor ($row = 1; $row <= 3; ++$row) {\n $cell = $worksheet->getCell(\"A{$row}\");\n $helper->log(\"A{$row}: \" . $cell->getValueString() . ' => ' . $cell->getCalculatedValueString());\n}\n"
},
{
"path": "samples/LookupRef/SortExcel.php",
"content": "arrayCol] : $rowA;\n $b = is_array($rowB) ? $rowB[$this->arrayCol] : $rowB;\n if ($a instanceof Stringable) {\n $a = (string) $a;\n }\n if ($b instanceof Stringable) {\n $b = (string) $b;\n }\n if (is_array($a) || is_object($a) || is_resource($a) || is_array($b) || is_object($b) || is_resource($b)) {\n throw new Exception('Invalid datatype');\n }\n // null sorts highest\n if ($a === null) {\n return ($b === null) ? 0 : $this->ascending;\n }\n if ($b === null) {\n return -$this->ascending;\n }\n // int|float sorts lowest\n $numericA = is_int($a) || is_float($a);\n $numericB = is_int($b) || is_float($b);\n if ($numericA && $numericB) {\n if ($a == $b) {\n return 0;\n }\n\n return ($a < $b) ? -$this->ascending : $this->ascending;\n }\n if ($numericA) {\n return -$this->ascending;\n }\n if ($numericB) {\n return $this->ascending;\n }\n // bool sorts higher than string\n if (is_bool($a)) {\n if (!is_bool($b)) {\n return $this->ascending;\n }\n if ($a) {\n return $b ? 0 : $this->ascending;\n }\n\n return $b ? -$this->ascending : 0;\n }\n if (is_bool($b)) {\n return -$this->ascending;\n }\n // special handling for numeric strings starting with -\n /** @var string $a */\n $a2 = (string) preg_replace('/^-(\\d)+$/', '$1', $a);\n /** @var string $b */\n $b2 = (string) preg_replace('/^-(\\d)+$/', '$1', $b);\n\n // strings sort case-insensitive\n return $this->ascending * strcasecmp($a2, $b2);\n }\n\n /**\n * @param mixed[] $array\n */\n public function sortArray(array &$array, int $ascending = self::ASCENDING, int $arrayCol = 0): void\n {\n if ($ascending !== 1 && $ascending !== -1) {\n throw new Exception('ascending must be 1 or -1');\n }\n $this->ascending = $ascending;\n $this->arrayCol = $arrayCol;\n usort($array, $this->cmp(...));\n }\n}\n\nrequire __DIR__ . '/../Header.php';\n/** @var Sample $helper */\n$helper->log('Emulating how Excel sorts different DataTypes');\n\n/** @param mixed[] $original */\nfunction displaySorted(array $original, Sample $helper): void\n{\n $sorted = $original;\n $sortExcel = new SortExcel();\n $sortExcel->sortArray($sorted);\n $outArray = [['Original', 'Sorted']];\n $count = count($original);\n for ($i = 0; $i < $count; ++$i) {\n $outArray[] = [$original[$i], $sorted[$i]];\n }\n $helper->displayGrid($outArray, TextGridRightAlign::floatOrInt);\n}\n\n$helper->log('First example');\n$original = ['-3', '40', 'A', 'B', true, false, '+3', '1', '10', '2', '25', 1, 0, -1];\ndisplaySorted($original, $helper);\n\n$helper->log('Second example');\n$original = ['a', 'A', null, 'x', 'X', true, false, -3, 1];\ndisplaySorted($original, $helper);\n"
},
{
"path": "samples/LookupRef/SortExcelCols.php",
"content": "arrayCol] : $rowA;\n $b = is_array($rowB) ? $rowB[$this->arrayCol] : $rowB;\n if ($a instanceof Stringable) {\n $a = (string) $a;\n }\n if ($b instanceof Stringable) {\n $b = (string) $b;\n }\n if (is_array($a) || is_object($a) || is_resource($a) || is_array($b) || is_object($b) || is_resource($b)) {\n throw new Exception('Invalid datatype');\n }\n // null sorts highest\n if ($a === null) {\n return ($b === null) ? 0 : $this->ascending;\n }\n if ($b === null) {\n return -$this->ascending;\n }\n // int|float sorts lowest\n $numericA = is_int($a) || is_float($a);\n $numericB = is_int($b) || is_float($b);\n if ($numericA && $numericB) {\n if ($a == $b) {\n return 0;\n }\n\n return ($a < $b) ? -$this->ascending : $this->ascending;\n }\n if ($numericA) {\n return -$this->ascending;\n }\n if ($numericB) {\n return $this->ascending;\n }\n // bool sorts higher than string\n if (is_bool($a)) {\n if (!is_bool($b)) {\n return $this->ascending;\n }\n if ($a) {\n return $b ? 0 : $this->ascending;\n }\n\n return $b ? -$this->ascending : 0;\n }\n if (is_bool($b)) {\n return -$this->ascending;\n }\n // special handling for numeric strings starting with -\n /** @var string $a */\n $a2 = (string) preg_replace('/^-(\\d)+$/', '$1', $a);\n /** @var string $b */\n $b2 = (string) preg_replace('/^-(\\d)+$/', '$1', $b);\n\n // strings sort case-insensitive\n return $this->ascending * strcasecmp($a2, $b2);\n }\n\n /**\n * @param mixed[] $array\n */\n public function sortArray(array &$array, int $ascending = self::ASCENDING, int $arrayCol = 0): void\n {\n if ($ascending !== 1 && $ascending !== -1) {\n throw new Exception('ascending must be 1 or -1');\n }\n $this->ascending = $ascending;\n $this->arrayCol = $arrayCol;\n usort($array, $this->cmp(...));\n }\n}\n\nrequire __DIR__ . '/../Header.php';\n/** @var Sample $helper */\n$helper->log('Emulating how Excel sorts different DataTypes by Column');\n\n$array = [\n ['a', 'a', 'a'],\n ['a', 'a', 'b'],\n ['a', null, 'c'],\n ['b', 'b', 1],\n ['b', 'c', 2],\n ['b', 'c', true],\n ['c', 1, false],\n ['c', 1, 'a'],\n ['c', 2, 'b'],\n [1, 2, 'c'],\n [1, true, 1],\n [1, true, 2],\n [2, false, true],\n [2, false, false],\n [2, 'a', false],\n [true, 'b', true],\n [true, 'c', 2],\n [true, 1, 1],\n [false, 2, 'a'],\n [false, true, 'b'],\n [false, false, 'c'],\n];\n\n/** @param arraySerif
\n$lorem
\nSans-Serif
\n$lorem
\nMonospace
\n$lorem
\n \n EOF;\n\n return preg_replace($bodystring, $bodyrepl, $html) ?? throw new SpreadsheetException('preg failed');\n}\n\nrequire __DIR__ . '/../Header.php';\n/** @var PhpOffice\\PhpSpreadsheet\\Spreadsheet */\n$spreadsheet = require __DIR__ . '/../templates/sampleSpreadsheet.php';\n\n/** @var PhpOffice\\PhpSpreadsheet\\Helper\\Sample $helper */\n$helper->log('Hide grid lines');\n$spreadsheet->getActiveSheet()->setShowGridLines(false);\n\n$helper->log('Set orientation to landscape');\n$spreadsheet->getActiveSheet()->getPageSetup()->setOrientation(PageSetup::ORIENTATION_LANDSCAPE);\n\n$helper->log('Write to Dompdf');\nIOFactory::registerWriter('Pdf', Dompdf::class);\n$filename = str_replace('.php', '_dompdf.php', __FILE__);\n$helper->write(\n $spreadsheet,\n $filename,\n ['Pdf'],\n false,\n function (Dompdf $writer): void {\n $writer->setEditHtmlCallback('replaceBody');\n }\n);\n\n$helper->log('Write to Mpdf');\nIOFactory::registerWriter('Pdf', Mpdf::class);\n$filename = str_replace('.php', '_mpdf.php', __FILE__);\n$helper->write(\n $spreadsheet,\n $filename,\n ['Pdf'],\n false,\n function (Mpdf $writer): void {\n $writer->setEditHtmlCallback('replaceBody');\n }\n);\n\n$helper->log('Write to Tcpdf');\nIOFactory::registerWriter('Pdf', TcpdfClass::class);\n$filename = str_replace('.php', '_tcpdf.php', __FILE__);\n$helper->write(\n $spreadsheet,\n $filename,\n ['Pdf'],\n false,\n function (TcpdfClass $writer): void {\n $writer->setEditHtmlCallback('replaceBody');\n }\n);\n" }, { "path": "samples/Pdf/21d_FitToHeightPdf.php", "content": "log('Read spreadsheet');\n$filename = '21d_FitToHeightPdf.xlsx';\n$fileWithPath = __DIR__ . \"/../templates/$filename\";\n$reader = new Xlsx();\n$spreadsheet = $reader->load($fileWithPath);\n$sheet = $spreadsheet->getActiveSheet();\n\n$helper->log('Write to Mpdf');\nIOFactory::registerWriter('Pdf', PhpOffice\\PhpSpreadsheet\\Writer\\Pdf\\Mpdf::class);\n$helper->write($spreadsheet, __FILE__, ['Pdf']);\n$spreadsheet->disconnectWorksheets();\n" }, { "path": "samples/Pdf/21e_UnusualFont_mpdf.php", "content": "getProperties()\n ->setCreator('PhpSpreadsheet')\n ->setTitle('Unusual Font');\n\n$helper->log('Show print grid lines');\n$sheet = $spreadsheet->getActiveSheet();\n$sheet->setPrintGridLines(true);\n\n$sheet->getCell('A1')->setValue('First Cell');\n$sheet->getCell('A2')->setValue('Second Cell');\n$sheet->getCell('B1')->setValue('Third Cell');\n$sheet->getCell('B2')->setValue('Fourth Cell');\n\n$helper->log('Set style to unusual font');\n$sheet->getStyle('A1:B2')->getFont()->setName('Shadows Into Light');\n\n$helper->log('Write to Mpdf');\n$writer = new Mpdf2($spreadsheet);\n$filename = $helper->getFileName(__FILE__, 'pdf');\n$writer->save($filename);\n$helper->log(\"Saved $filename\");\nif (PHP_SAPI !== 'cli') {\n echo 'Download ' . basename($filename) . '';\n}\n$spreadsheet->disconnectWorksheets();\n" }, { "path": "samples/Pdf/21f_Drawing.php", "content": "getActiveSheet();\n\n$sheet->getCell('A1')->setValue('A1');\n$sheet->getCell('B1')->setValue('B');\n$sheet->getCell('C1')->setValue('C');\n$sheet->getCell('D1')->setValue('D');\n$sheet->getCell('E1')->setValue('E');\n$sheet->getCell('F1')->setValue('F');\n$sheet->getCell('G1')->setValue('G');\n$sheet->getCell('A2')->setValue('A2');\n$sheet->getCell('A3')->setValue('A3');\n$sheet->getCell('A4')->setValue('A4');\n$sheet->getCell('A5')->setValue('A5');\n$sheet->getCell('A6')->setValue('A6');\n$sheet->getCell('A7')->setValue('A7');\n$sheet->getCell('A8')->setValue('A8');\n\n$helper->log('Add drawing to worksheet');\n$drawing = new Drawing();\n$drawing->setName('Blue Square');\n$path = __DIR__ . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . 'images/blue_square.png';\n$drawing->setPath($path);\n$drawing->setResizeProportional(false);\n$drawing->setWidth(320);\n$drawing->setCoordinates('B2');\n$drawing->setCoordinates2('G6');\n$drawing->setWorksheet($sheet, true);\n\n$helper->log('Merge drawing cells for Pdf');\n$spreadsheet->mergeDrawingCellsForPdf();\n\n$helper->log('Write to Mpdf');\n$helper->write($spreadsheet, __FILE__, ['Mpdf']);\n\n$spreadsheet->disconnectWorksheets();\n" }, { "path": "samples/Pdf/21g_Direction.php", "content": "getActiveSheet();\n\n$sheet1 = $spreadsheet->getActiveSheet();\n$sheet2 = $spreadsheet->createSheet();\n$sheet3 = $spreadsheet->createSheet();\n$cells = [\n ['a1', 'b1', 'c1'],\n ['a2', 'b2', 'c2'],\n];\n$sheet1->fromArray($cells);\n$sheet1->setRightToLeft(true);\n$sheet2->fromArray($cells);\n$sheet3->fromArray($cells);\n$sheet3->setRightToLeft(true);\n\n$helper->log('Write to html, mpdf, tcpdf');\n// Save\n$helper->write($spreadsheet, __FILE__, ['Html', 'Mpdf', 'Tcpdf']);\n\n$spreadsheet->disconnectWorksheets();\n" }, { "path": "samples/Pdf/21h_DirectionMultiple.php", "content": "getActiveSheet();\n\n$sheet1 = $spreadsheet->getActiveSheet();\n$sheet2 = $spreadsheet->createSheet();\n$sheet3 = $spreadsheet->createSheet();\n$cells = [\n ['a1', 'b1', 'c1'],\n ['a2', 'b2', 'c2'],\n];\n$sheet1->fromArray($cells);\n$sheet1->setRightToLeft(true);\n$sheet2->fromArray($cells);\n$sheet3->fromArray($cells);\n$sheet3->setRightToLeft(true);\n\n$helper->log('Write to html, mpdf');\n// Save\n$helper->write(\n $spreadsheet,\n __FILE__,\n ['Html', 'Mpdf'],\n writerCallback: function (HtmlWriter $writer): void {\n $writer->writeAllSheets();\n }\n);\n\n$spreadsheet->disconnectWorksheets();\n" }, { "path": "samples/Pdf/Dompdf_Canvas_Headers.php", "content": "getCanvas()->page_script(function (\n int $pageNumber,\n int $pageCount,\n Canvas $canvas,\n FontMetrics $fontMetrics\n ): void {\n // Get font metrics for dynamic content like page numbers\n $fontName = 'helvetica'; // note lowercase\n $fontType = 'bold'; // note lowercase\n $font = $fontMetrics->getFont($fontName, $fontType) ?? throw new Exception(\"no font metrics for $fontName $fontType\");\n // Example text placement (adjust coordinates and font as needed)\n if ($pageNumber === 1) {\n $header = 'Dompdf First Page';\n } elseif ($pageNumber % 2 === 0) {\n $header = 'Dompdf Even Page';\n } else {\n $header = 'Dompdf Odd Page';\n }\n $text = \"$header Page $pageNumber of $pageCount\";\n $canvas->text(40, 20, $text, $font, 12);\n });\n }\n}\n\n$spreadsheet = new Spreadsheet();\n$sheet = $spreadsheet->getActiveSheet();\n$counter = 0;\n/** @var PhpOffice\\PhpSpreadsheet\\Helper\\Sample $helper */\n$helper->log('Populate spreadsheet');\nfor ($row = 1; $row < 1001; ++$row) {\n $sheet->getCell(\"A$row\")->setValue(++$counter);\n // Add many styles by using slight variations of font color for each.\n $sheet->getCell(\"A$row\")->getStyle()->getFont()\n ->getColor()->setRgb(sprintf('%06x', $counter));\n $sheet->getCell(\"B$row\")->setValue(++$counter);\n $sheet->getCell(\"C$row\")->setValue(++$counter);\n}\n\n$helper->log('Write to Dompdf with headers added by page_script');\nIOFactory::registerWriter('Pdf', Dompdf_Canvas_Headers::class);\n$helper->write($spreadsheet, __FILE__, ['Pdf']);\n$spreadsheet->disconnectWorksheets();\n" }, { "path": "samples/Pdf/Dompdf_Custom_Headers.php", "content": "\n header {\n position: fixed;\n top: -0.5in; /* Position in top margin area */\n height: 0.5in;\n width: 100%;\n text-align: center;\n }\n footer {\n position: fixed;\n bottom: -0.5in; /* Position in bottom margin area */\n height: 0.5in;\n width: 100%;\n text-align: right;\n }\n .pagenum:before {content: counter(page);}\n \n\n EOF;\n $endhead = '';\n $html = str_replace($endhead, \"$headerFooter$endhead\", $html);\n $bodystring = '';\n $bodyrepl = <<
Worksheet Names
');\n$helper->log('- ');\nforeach ($worksheetNames as $worksheetName) {\n $helper->log('
- ' . $worksheetName . ' ');\n}\n$helper->log('
Worksheet Information
');\n$helper->log('- ');\nforeach ($worksheetData as $worksheet) {\n $helper->log('
- ' . $worksheet['worksheetName']);\n $helper->log('Rows: ' . $worksheet['totalRows'] . ' Columns: ' . $worksheet['totalColumns']);\n $helper->log('Cell Range: A1:' . $worksheet['lastColumnLetter'] . $worksheet['totalRows']);\n $helper->log(' ');\n}\n$helper->log('
Code:
');\n $helper->log('use PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard;');\n $helper->log(\n \"\\$wizard = new Wizard\\\\Accounting('{$_POST['currency']}', {$_POST['decimals']}, Wizard\\\\Number::\"\n . (isset($_POST['thousands']) ? 'WITH_THOUSANDS_SEPARATOR' : 'WITHOUT_THOUSANDS_SEPARATOR')\n . ', Wizard\\Currency::' . (((bool) $_POST['position']) ? 'LEADING_SYMBOL' : 'TRAILING_SYMBOL')\n . ');'\n );\n $helper->log('$mask = $wizard->format();');\n $helper->log('
echo (string) $mask;');\n $helper->log('
Mask:
');\n $helper->log($mask . '
');\n $helper->log('
Example:
');\n $helper->log($example);\n } catch (SpreadsheetException $e) {\n $helper->log(\"Exception: {$e->getMessage()}\");\n }\n }\n}\n" }, { "path": "samples/Wizards/NumberFormat/Currency.php", "content": "isCli()) {\n $helper->log('This example should only be run from a Web Browser' . PHP_EOL);\n\n return;\n}\n\n$negatives = [\n CurrencyNegative::minus,\n CurrencyNegative::redMinus,\n CurrencyNegative::parentheses,\n CurrencyNegative::redParentheses,\n];\n$negativesString = [\n 'CurrencyNegative::minus',\n 'CurrencyNegative::redMinus',\n 'CurrencyNegative::parentheses',\n 'CurrencyNegative::redParentheses',\n];\n\n$currencies = [\n '$' => 'US Dollars ($)',\n '€' => 'Euro (€)',\n '¥' => 'Japanese Yen (¥)',\n '£' => 'Pound Sterling (£)',\n '₹' => 'Rupee (₹)',\n '₽' => 'Rouble (₽)',\n];\n\n$postNegative = StringHelper::convertPostToString('negative');\nif (!in_array($postNegative, ['0', '1', '2', '3'], true)) {\n $postNegative = '0';\n}\n$postNegative = (int) $postNegative;\n?>\n \n\nlog('The Sample Number Value must be numeric');\n } elseif (!is_numeric($_POST['decimals']) || str_contains((string) $_POST['decimals'], '.') || (int) $_POST['decimals'] < 0) {\n $helper->log('The Decimal Places value must be positive integer');\n } elseif (!in_array($_POST['currency'], array_keys($currencies), true)) {\n $helper->log('Unrecognized currency symbol');\n } else {\n try {\n $negative = $negatives[$postNegative];\n $wizard = new Wizard\\Currency($_POST['currency'], (int) $_POST['decimals'], isset($_POST['thousands']), (bool) $_POST['position']);\n $wizard->setNegative($negative);\n $mask = $wizard->format();\n $example = (string) NumberFormat::toFormattedString((float) $_POST['number'], $mask, [HtmlWriter::class, 'formatColorStatic']);\n $helper->log('
Code:
');\n $helper->log('use PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard;');\n $helper->log('use PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\CurrencyNegative;');\n $helper->log(\n \"\\$wizard = new Wizard\\\\Currency('{$_POST['currency']}', {$_POST['decimals']}, Wizard\\\\Number::\"\n . (isset($_POST['thousands']) ? 'WITH_THOUSANDS_SEPARATOR' : 'WITHOUT_THOUSANDS_SEPARATOR')\n . ', Wizard\\Currency::' . (((bool) $_POST['position']) ? 'LEADING_SYMBOL' : 'TRAILING_SYMBOL')\n . ');'\n );\n $helper->log('$wizard->setNegative(' . $negativesString[$postNegative] . ');');\n $helper->log('$mask = $wizard->format();');\n $helper->log('
echo (string) $mask;');\n $helper->log('
Mask:
');\n $helper->log($mask . '
');\n $helper->log('
Example:
');\n $helper->log($example);\n } catch (SpreadsheetException $e) {\n $helper->log(\"Exception: {$e->getMessage()}\");\n }\n }\n}\n" }, { "path": "samples/Wizards/NumberFormat/Number.php", "content": "isCli()) {\n $helper->log('This example should only be run from a Web Browser' . PHP_EOL);\n\n return;\n}\n?>\n \n\nlog('The Sample Number Value must be numeric');\n } elseif (!is_numeric($_POST['decimals']) || str_contains((string) $_POST['decimals'], '.') || (int) $_POST['decimals'] < 0) {\n $helper->log('The Decimal Places value must be positive integer');\n } else {\n try {\n $wizard = new Wizard\\Number((int) $_POST['decimals'], isset($_POST['thousands']));\n $mask = $wizard->format();\n $example = NumberFormat::toFormattedString((float) $_POST['number'], $mask);\n $helper->log('
Code:
');\n $helper->log('use PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard;');\n $helper->log(\n \"\\$mask = Wizard\\\\Number({$_POST['decimals']}, Wizard\\\\Number::\"\n . (isset($_POST['thousands']) ? 'WITH_THOUSANDS_SEPARATOR' : 'WITHOUT_THOUSANDS_SEPARATOR')\n . ');
'\n );\n $helper->log('echo (string) $mask;');\n $helper->log('
Mask:');\n $helper->log($mask);\n $helper->log('Example:');\n $helper->log($example);\n } catch (SpreadsheetException $e) {\n $helper->log(\"Exception: {$e->getMessage()}\");\n }\n }\n}\n" }, { "path": "samples/Wizards/NumberFormat/Percentage.php", "content": "isCli()) {\n $helper->log('This example should only be run from a Web Browser' . PHP_EOL);\n\n return;\n}\n?>\n \n\nlog('The Sample Number Value must be numeric');\n } elseif (!is_numeric($_POST['decimals']) || str_contains((string) $_POST['decimals'], '.') || (int) $_POST['decimals'] < 0) {\n $helper->log('The Decimal Places value must be positive integer');\n } else {\n try {\n $wizard = new Wizard\\Percentage((int) $_POST['decimals']);\n $mask = $wizard->format();\n $example = (string) NumberFormat::toFormattedString((float) $_POST['number'], $mask);\n $helper->log('
Code:
');\n $helper->log('use PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard;');\n $helper->log(\"\\$mask = Wizard\\\\Percentage({$_POST['decimals']});
\");\n $helper->log('echo (string) $mask;');\n $helper->log('
Mask:
');\n $helper->log($mask . '
');\n $helper->log('
Example:
');\n $helper->log($example);\n } catch (SpreadsheetException $e) {\n $helper->log(\"Exception: {$e->getMessage()}\");\n }\n }\n}\n" }, { "path": "samples/Wizards/NumberFormat/Scientific.php", "content": "isCli()) {\n $helper->log('This example should only be run from a Web Browser' . PHP_EOL);\n\n return;\n}\n?>\n \n\nlog('The Sample Number Value must be numeric');\n } elseif (!is_numeric($_POST['decimals']) || str_contains((string) $_POST['decimals'], '.') || (int) $_POST['decimals'] < 0) {\n $helper->log('The Decimal Places value must be positive integer');\n } else {\n try {\n $wizard = new Wizard\\Scientific((int) $_POST['decimals']);\n $mask = $wizard->format();\n $example = (string) NumberFormat::toFormattedString((float) $_POST['number'], $mask);\n $helper->log('
Code:
');\n $helper->log('use PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard;');\n $helper->log(\"\\$mask = Wizard\\\\Scientific({$_POST['decimals']});
\");\n $helper->log('echo (string) $mask;');\n $helper->log('
Mask:
');\n $helper->log($mask . '
');\n $helper->log('
Example:
');\n $helper->log($example);\n } catch (SpreadsheetException $e) {\n $helper->log(\"Exception: {$e->getMessage()}\");\n }\n }\n}\n" }, { "path": "samples/bootstrap/css/phpspreadsheet.css", "content": "body {\n padding-top: 20px;\n padding-bottom: 20px;\n}\n.navbar {\n margin-bottom: 20px;\n}\n.navbar + h1 {\n margin-top: 70px;\n}\n.passed {\n color: #339900;\n}\n.failed {\n color: #ff0000;\n}" }, { "path": "samples/download.php", "content": "getTemporaryFolder(), $filename, $filetype);\n $downloader->download();\n} catch (Exception $e) {\n exit($e->getMessage());\n}\n" }, { "path": "samples/index.php", "content": " version_compare(PHP_VERSION, '8.1', '>='),\n 'PHP extension XML' => extension_loaded('xml'),\n 'PHP extension xmlwriter' => extension_loaded('xmlwriter'),\n 'PHP extension mbstring' => extension_loaded('mbstring'),\n 'PHP extension ZipArchive' => extension_loaded('zip'),\n 'PHP extension GD (optional)' => extension_loaded('gd'),\n 'PHP extension dom (optional)' => extension_loaded('dom'),\n];\n\n/** @var PhpOffice\\PhpSpreadsheet\\Helper\\Sample $helper */\nif (!$helper->isCli()) {\n ?>\n
\n
\n Requirement check';\n echo 'Welcome to PHPSpreadsheet, a library written in pure PHP and providing a set of classes that allow you to read from and to write to different spreadsheet file formats, like Excel and LibreOffice Calc.
\n\n
\n Fork us on Github!\n Read the Docs\n
\n- ';\n foreach ($requirements as $label => $result) {\n $status = $result ? 'passed' : 'failed';\n echo \"
- {$label} ... {$status} \";\n }\n echo '
| Color Name | \nHEX | \nColor | \n
|---|---|---|
| Black | \n#000000 | \n\n |
| Blue | \n#0000FF | \n\n |
| Green | \n#008000 | \n\n |
| Cyan | \n#00FFFF | \n\n |
| Purple | \n#800080 | \n\n |
| Grey | \n#808080 | \n\n |
| SkyBlue | \n#87CEEB | \n\n |
| Brown | \n#A52A2A | \n\n |
| Silver | \n#C0C0C0 | \n\n |
| Chocolate | \n#D2691E | \n\n |
| Tan | \n#D2B48C | \n\n |
| Violet | \n#EE82EE | \n\n |
| Red | \n#FF0000 | \n\n |
| Pink | \n#FFC0CB | \n\n |
| Gold | \n#FFD700 | \n\n |
| Yellow | \n#FFFF00 | \n\n |
| LightYellow | \n#FFFFE0 | \n\n |
| White | \n#FFFFFF | \n\n |