# tablepress/3.4/libraries/vendor/PhpSpreadsheet/Calculation/MathTrig/Factorial.php

TablePress – Tables in WordPress made easy, version 3.4. 129 lines.

- Page: https://pluginprobe.com/plugins/tablepress/3.4/code/libraries/vendor/PhpSpreadsheet/Calculation/MathTrig/Factorial.php
- Raw: https://pluginprobe.com/plugins/tablepress/3.4/raw/libraries/vendor/PhpSpreadsheet/Calculation/MathTrig/Factorial.php
- Modified: 2025-08-26T04:06:14+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/tablepress/3.4/code/libraries/vendor/PhpSpreadsheet/Calculation/MathTrig/Factorial.php#L10-L20`.

```php
<?php

namespace TablePress\PhpOffice\PhpSpreadsheet\Calculation\MathTrig;

use TablePress\PhpOffice\PhpSpreadsheet\Calculation\ArrayEnabled;
use TablePress\PhpOffice\PhpSpreadsheet\Calculation\Exception;
use TablePress\PhpOffice\PhpSpreadsheet\Calculation\Functions;
use TablePress\PhpOffice\PhpSpreadsheet\Calculation\Information\ExcelError;
use TablePress\PhpOffice\PhpSpreadsheet\Calculation\Statistical;

class Factorial
{
	use ArrayEnabled;

	/**
	 * FACT.
	 *
	 * Returns the factorial of a number.
	 * The factorial of a number is equal to 1*2*3*...* number.
	 *
	 * Excel Function:
	 *        FACT(factVal)
	 *
	 * @param array<mixed>|float $factVal Factorial Value, or can be an array of numbers
	 *
	 * @return array<mixed>|float|int|string Factorial, or a string containing an error
	 *         If an array of numbers is passed as the argument, then the returned result will also be an array
	 *            with the same dimensions
	 */
	public static function fact($factVal)
	{
		if (is_array($factVal)) {
			return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $factVal);
		}

		try {
			$factVal = Helpers::validateNumericNullBool($factVal);
			Helpers::validateNotNegative($factVal);
		} catch (Exception $e) {
			return $e->getMessage();
		}

		$factLoop = floor($factVal);
		if ($factVal > $factLoop) {
			if (Functions::getCompatibilityMode() == Functions::COMPATIBILITY_GNUMERIC) {
				return Statistical\Distributions\Gamma::gammaValue($factVal + 1);
			}
		}

		$factorial = 1;
		while ($factLoop > 1) {
			$factorial *= $factLoop--;
		}

		return $factorial;
	}

	/**
	 * FACTDOUBLE.
	 *
	 * Returns the double factorial of a number.
	 *
	 * Excel Function:
	 *        FACTDOUBLE(factVal)
	 *
	 * @param array<mixed>|float $factVal Factorial Value, or can be an array of numbers
	 *
	 * @return array<mixed>|float|int|string Double Factorial, or a string containing an error
	 *         If an array of numbers is passed as the argument, then the returned result will also be an array
	 *            with the same dimensions
	 */
	public static function factDouble($factVal)
	{
		if (is_array($factVal)) {
			return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $factVal);
		}

		try {
			$factVal = Helpers::validateNumericNullSubstitution($factVal, 0);
			Helpers::validateNotNegative($factVal);
		} catch (Exception $e) {
			return $e->getMessage();
		}

		$factLoop = floor($factVal);
		$factorial = 1;
		while ($factLoop > 1) {
			$factorial *= $factLoop;
			$factLoop -= 2;
		}

		return $factorial;
	}

	/**
	 * MULTINOMIAL.
	 *
	 * Returns the ratio of the factorial of a sum of values to the product of factorials.
	 *
	 * @param mixed[] $args An array of mixed values for the Data Series
	 *
	 * @return float|int|string The result, or a string containing an error
	 */
	public static function multinomial(...$args)
	{
		$summer = 0;
		$divisor = 1;

		try {
			// Loop through arguments
			foreach (Functions::flattenArray($args) as $argx) {
				$arg = Helpers::validateNumericNullSubstitution($argx, null);
				Helpers::validateNotNegative($arg);
				$arg = (int) $arg;
				$summer += $arg;
				/** @var float|int */
				$temp = self::fact($arg);
				$divisor *= $temp;
			}
		} catch (Exception $e) {
			return $e->getMessage();
		}

		$summer = self::fact($summer);

		return is_numeric($summer) ? ($summer / $divisor) : ExcelError::VALUE();
	}
}

```