Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 3.11.x will end 14 Nov 2022 (12 months plus 6 months extension).
  • Bug fixes for security issues in 3.11.x will end 13 Nov 2023 (18 months plus 12 months extension).
  • PHP version: minimum PHP 7.3.0 Note: minimum PHP version has increased since Moodle 3.10. PHP 7.4.x is supported too.
<?php

namespace PhpOffice\PhpSpreadsheet\Calculation;

use PhpOffice\PhpSpreadsheet\Cell\Cell;

class Functions
{
    const PRECISION = 8.88E-016;

    /**
     * 2 / PI.
     */
    const M_2DIVPI = 0.63661977236758134307553505349006;

    /** constants */
    const COMPATIBILITY_EXCEL = 'Excel';
    const COMPATIBILITY_GNUMERIC = 'Gnumeric';
    const COMPATIBILITY_OPENOFFICE = 'OpenOfficeCalc';

    const RETURNDATE_PHP_NUMERIC = 'P';
    const RETURNDATE_UNIX_TIMESTAMP = 'P';
    const RETURNDATE_PHP_OBJECT = 'O';
    const RETURNDATE_PHP_DATETIME_OBJECT = 'O';
    const RETURNDATE_EXCEL = 'E';

    /**
     * Compatibility mode to use for error checking and responses.
     *
     * @var string
     */
    protected static $compatibilityMode = self::COMPATIBILITY_EXCEL;

    /**
     * Data Type to use when returning date values.
     *
     * @var string
     */
    protected static $returnDateType = self::RETURNDATE_EXCEL;

    /**
     * List of error codes.
     *
     * @var array
     */
    protected static $errorCodes = [
        'null' => '#NULL!',
        'divisionbyzero' => '#DIV/0!',
        'value' => '#VALUE!',
        'reference' => '#REF!',
        'name' => '#NAME?',
        'num' => '#NUM!',
        'na' => '#N/A',
        'gettingdata' => '#GETTING_DATA',
    ];

    /**
     * Set the Compatibility Mode.
     *
< * @category Function Configuration < *
* @param string $compatibilityMode Compatibility Mode * Permitted values are: * Functions::COMPATIBILITY_EXCEL 'Excel' * Functions::COMPATIBILITY_GNUMERIC 'Gnumeric' * Functions::COMPATIBILITY_OPENOFFICE 'OpenOfficeCalc' * * @return bool (Success or Failure) */ public static function setCompatibilityMode($compatibilityMode) {
< if (($compatibilityMode == self::COMPATIBILITY_EXCEL) ||
> if ( > ($compatibilityMode == self::COMPATIBILITY_EXCEL) ||
($compatibilityMode == self::COMPATIBILITY_GNUMERIC) || ($compatibilityMode == self::COMPATIBILITY_OPENOFFICE) ) { self::$compatibilityMode = $compatibilityMode; return true; } return false; } /** * Return the current Compatibility Mode. *
< * @category Function Configuration < *
* @return string Compatibility Mode * Possible Return values are: * Functions::COMPATIBILITY_EXCEL 'Excel' * Functions::COMPATIBILITY_GNUMERIC 'Gnumeric' * Functions::COMPATIBILITY_OPENOFFICE 'OpenOfficeCalc' */ public static function getCompatibilityMode() { return self::$compatibilityMode; } /** * Set the Return Date Format used by functions that return a date/time (Excel, PHP Serialized Numeric or PHP Object). *
< * @category Function Configuration < *
* @param string $returnDateType Return Date Format * Permitted values are: * Functions::RETURNDATE_UNIX_TIMESTAMP 'P' * Functions::RETURNDATE_PHP_DATETIME_OBJECT 'O' * Functions::RETURNDATE_EXCEL 'E' * * @return bool Success or failure */ public static function setReturnDateType($returnDateType) {
< if (($returnDateType == self::RETURNDATE_UNIX_TIMESTAMP) ||
> if ( > ($returnDateType == self::RETURNDATE_UNIX_TIMESTAMP) ||
($returnDateType == self::RETURNDATE_PHP_DATETIME_OBJECT) || ($returnDateType == self::RETURNDATE_EXCEL) ) { self::$returnDateType = $returnDateType; return true; } return false; } /** * Return the current Return Date Format for functions that return a date/time (Excel, PHP Serialized Numeric or PHP Object). *
< * @category Function Configuration < *
* @return string Return Date Format * Possible Return values are: * Functions::RETURNDATE_UNIX_TIMESTAMP 'P' * Functions::RETURNDATE_PHP_DATETIME_OBJECT 'O' * Functions::RETURNDATE_EXCEL 'E' */ public static function getReturnDateType() { return self::$returnDateType; } /** * DUMMY. *
< * @category Error Returns < *
* @return string #Not Yet Implemented */ public static function DUMMY() { return '#Not Yet Implemented'; } /** * DIV0. *
< * @category Error Returns < *
* @return string #Not Yet Implemented */ public static function DIV0() { return self::$errorCodes['divisionbyzero']; } /** * NA. * * Excel Function: * =NA() * * Returns the error value #N/A * #N/A is the error value that means "no value is available." *
< * @category Logical Functions < *
* @return string #N/A! */ public static function NA() { return self::$errorCodes['na']; } /** * NaN. * * Returns the error value #NUM! *
< * @category Error Returns < *
* @return string #NUM! */ public static function NAN() { return self::$errorCodes['num']; } /** * NAME. * * Returns the error value #NAME? *
< * @category Error Returns < *
* @return string #NAME? */ public static function NAME() { return self::$errorCodes['name']; } /** * REF. * * Returns the error value #REF! *
< * @category Error Returns < *
* @return string #REF! */ public static function REF() { return self::$errorCodes['reference']; } /** * NULL. * * Returns the error value #NULL! *
< * @category Error Returns < *
* @return string #NULL! */ public static function null() { return self::$errorCodes['null']; } /** * VALUE. * * Returns the error value #VALUE! *
< * @category Error Returns < *
* @return string #VALUE! */ public static function VALUE() { return self::$errorCodes['value']; } public static function isMatrixValue($idx) { return (substr_count($idx, '.') <= 1) || (preg_match('/\.[A-Z]/', $idx) > 0); } public static function isValue($idx) { return substr_count($idx, '.') == 0; } public static function isCellValue($idx) { return substr_count($idx, '.') > 1; } public static function ifCondition($condition) { $condition = self::flattenSingleValue($condition); if ($condition === '') { $condition = '=""'; } if (!is_string($condition) || !in_array($condition[0], ['>', '<', '='])) { if (!is_numeric($condition)) { $condition = Calculation::wrapResult(strtoupper($condition)); } return str_replace('""""', '""', '=' . $condition); } preg_match('/(=|<[>=]?|>=?)(.*)/', $condition, $matches); [, $operator, $operand] = $matches; if (is_numeric(trim($operand, '"'))) { $operand = trim($operand, '"'); } elseif (!is_numeric($operand)) { $operand = str_replace('"', '""', $operand); $operand = Calculation::wrapResult(strtoupper($operand)); } return str_replace('""""', '""', $operator . $operand); } /** * ERROR_TYPE. * * @param mixed $value Value to check * * @return bool */ public static function errorType($value = '') { $value = self::flattenSingleValue($value); $i = 1; foreach (self::$errorCodes as $errorCode) { if ($value === $errorCode) { return $i; } ++$i; } return self::NA(); } /** * IS_BLANK. * * @param mixed $value Value to check * * @return bool */ public static function isBlank($value = null) { if ($value !== null) { $value = self::flattenSingleValue($value); } return $value === null; } /** * IS_ERR. * * @param mixed $value Value to check * * @return bool */ public static function isErr($value = '') { $value = self::flattenSingleValue($value); return self::isError($value) && (!self::isNa(($value))); } /** * IS_ERROR. * * @param mixed $value Value to check * * @return bool */ public static function isError($value = '') { $value = self::flattenSingleValue($value); if (!is_string($value)) { return false; } return in_array($value, self::$errorCodes); } /** * IS_NA. * * @param mixed $value Value to check * * @return bool */ public static function isNa($value = '') { $value = self::flattenSingleValue($value); return $value === self::NA(); } /** * IS_EVEN. * * @param mixed $value Value to check * * @return bool|string */ public static function isEven($value = null) { $value = self::flattenSingleValue($value); if ($value === null) { return self::NAME(); } elseif ((is_bool($value)) || ((is_string($value)) && (!is_numeric($value)))) { return self::VALUE(); } return $value % 2 == 0; } /** * IS_ODD. * * @param mixed $value Value to check * * @return bool|string */ public static function isOdd($value = null) { $value = self::flattenSingleValue($value); if ($value === null) { return self::NAME(); } elseif ((is_bool($value)) || ((is_string($value)) && (!is_numeric($value)))) { return self::VALUE(); } return abs($value) % 2 == 1; } /** * IS_NUMBER. * * @param mixed $value Value to check * * @return bool */ public static function isNumber($value = null) { $value = self::flattenSingleValue($value); if (is_string($value)) { return false; } return is_numeric($value); } /** * IS_LOGICAL. * * @param mixed $value Value to check * * @return bool */ public static function isLogical($value = null) { $value = self::flattenSingleValue($value); return is_bool($value); } /** * IS_TEXT. * * @param mixed $value Value to check * * @return bool */ public static function isText($value = null) { $value = self::flattenSingleValue($value); return is_string($value) && !self::isError($value); } /** * IS_NONTEXT. * * @param mixed $value Value to check * * @return bool */ public static function isNonText($value = null) { return !self::isText($value); } /** * N. * * Returns a value converted to a number * * @param null|mixed $value The value you want converted * * @return number N converts values listed in the following table * If value is or refers to N returns * A number That number * A date The serial number of that date * TRUE 1 * FALSE 0 * An error value The error value * Anything else 0 */ public static function n($value = null) { while (is_array($value)) { $value = array_shift($value); } switch (gettype($value)) { case 'double': case 'float': case 'integer': return $value; case 'boolean': return (int) $value; case 'string': // Errors if ((strlen($value) > 0) && ($value[0] == '#')) { return $value; } break; } return 0; } /** * TYPE. * * Returns a number that identifies the type of a value * * @param null|mixed $value The value you want tested * * @return number N converts values listed in the following table * If value is or refers to N returns * A number 1 * Text 2 * Logical Value 4 * An error value 16 * Array or Matrix 64 */ public static function TYPE($value = null) { $value = self::flattenArrayIndexed($value); if (is_array($value) && (count($value) > 1)) { end($value); $a = key($value); // Range of cells is an error if (self::isCellValue($a)) { return 16; // Test for Matrix } elseif (self::isMatrixValue($a)) { return 64; } } elseif (empty($value)) { // Empty Cell return 1; } $value = self::flattenSingleValue($value); if (($value === null) || (is_float($value)) || (is_int($value))) { return 1; } elseif (is_bool($value)) { return 4; } elseif (is_array($value)) { return 64; } elseif (is_string($value)) { // Errors if ((strlen($value) > 0) && ($value[0] == '#')) { return 16; } return 2; } return 0; } /** * Convert a multi-dimensional array to a simple 1-dimensional array. * * @param array $array Array to be flattened * * @return array Flattened array */ public static function flattenArray($array) { if (!is_array($array)) { return (array) $array; } $arrayValues = []; foreach ($array as $value) { if (is_array($value)) { foreach ($value as $val) { if (is_array($val)) { foreach ($val as $v) { $arrayValues[] = $v; } } else { $arrayValues[] = $val; } } } else { $arrayValues[] = $value; } } return $arrayValues; } /** * Convert a multi-dimensional array to a simple 1-dimensional array, but retain an element of indexing. * * @param array $array Array to be flattened * * @return array Flattened array */ public static function flattenArrayIndexed($array) { if (!is_array($array)) { return (array) $array; } $arrayValues = []; foreach ($array as $k1 => $value) { if (is_array($value)) { foreach ($value as $k2 => $val) { if (is_array($val)) { foreach ($val as $k3 => $v) { $arrayValues[$k1 . '.' . $k2 . '.' . $k3] = $v; } } else { $arrayValues[$k1 . '.' . $k2] = $val; } } } else { $arrayValues[$k1] = $value; } } return $arrayValues; } /** * Convert an array to a single scalar value by extracting the first element. * * @param mixed $value Array or scalar value * * @return mixed */ public static function flattenSingleValue($value = '') { while (is_array($value)) {
< $value = array_pop($value);
> $value = array_shift($value);
} return $value; } /** * ISFORMULA. * * @param mixed $cellReference The cell to check * @param Cell $pCell The current cell (containing this formula) * * @return bool|string */
< public static function isFormula($cellReference = '', Cell $pCell = null)
> public static function isFormula($cellReference = '', ?Cell $pCell = null)
{ if ($pCell === null) { return self::REF(); } preg_match('/^' . Calculation::CALCULATION_REGEXP_CELLREF . '$/i', $cellReference, $matches); $cellReference = $matches[6] . $matches[7];
< $worksheetName = trim($matches[3], "'");
> $worksheetName = str_replace("''", "'", trim($matches[2], "'"));
$worksheet = (!empty($worksheetName)) ? $pCell->getWorksheet()->getParent()->getSheetByName($worksheetName) : $pCell->getWorksheet(); return $worksheet->getCell($cellReference)->isFormula(); } }