1) { $character = mb_substr($characters, 0, 1, 'UTF-8'); } return self::unicodeToOrd($character); } if (strlen($characters) > 0) { $character = substr($characters, 0, 1); } return ord($character); } /** * CONCATENATE. * * @return string */ public static function CONCATENATE(...$args) { $returnValue = ''; // Loop through arguments $aArgs = Functions::flattenArray($args); foreach ($aArgs as $arg) { if (is_bool($arg)) { if (Functions::getCompatibilityMode() == Functions::COMPATIBILITY_OPENOFFICE) { $arg = (int) $arg; } else { $arg = ($arg) ? \PhpOffice\PhpSpreadsheet\Calculation::getTRUE() : \PhpOffice\PhpSpreadsheet\Calculation::getFALSE(); } } $returnValue .= $arg; } return $returnValue; } /** * DOLLAR. * * This function converts a number to text using currency format, with the decimals rounded to the specified place. * The format used is $#,##0.00_);($#,##0.00).. * * @param float $value The value to format * @param int $decimals The number of digits to display to the right of the decimal point. * If decimals is negative, number is rounded to the left of the decimal point. * If you omit decimals, it is assumed to be 2 * * @return string */ public static function DOLLAR($value = 0, $decimals = 2) { $value = Functions::flattenSingleValue($value); $decimals = is_null($decimals) ? 0 : Functions::flattenSingleValue($decimals); // Validate parameters if (!is_numeric($value) || !is_numeric($decimals)) { return Functions::NAN(); } $decimals = floor($decimals); $mask = '$#,##0'; if ($decimals > 0) { $mask .= '.' . str_repeat('0', $decimals); } else { $round = pow(10, abs($decimals)); if ($value < 0) { $round = 0 - $round; } $value = MathTrig::MROUND($value, $round); } return \PhpOffice\PhpSpreadsheet\Style\NumberFormat::toFormattedString($value, $mask); } /** * SEARCHSENSITIVE. * * @param string $needle The string to look for * @param string $haystack The string in which to look * @param int $offset Offset within $haystack * * @return string */ public static function SEARCHSENSITIVE($needle, $haystack, $offset = 1) { $needle = Functions::flattenSingleValue($needle); $haystack = Functions::flattenSingleValue($haystack); $offset = Functions::flattenSingleValue($offset); if (!is_bool($needle)) { if (is_bool($haystack)) { $haystack = ($haystack) ? \PhpOffice\PhpSpreadsheet\Calculation::getTRUE() : \PhpOffice\PhpSpreadsheet\Calculation::getFALSE(); } if (($offset > 0) && (\PhpOffice\PhpSpreadsheet\Shared\StringHelper::countCharacters($haystack) > $offset)) { if (\PhpOffice\PhpSpreadsheet\Shared\StringHelper::countCharacters($needle) == 0) { return $offset; } if (function_exists('mb_strpos')) { $pos = mb_strpos($haystack, $needle, --$offset, 'UTF-8'); } else { $pos = strpos($haystack, $needle, --$offset); } if ($pos !== false) { return ++$pos; } } } return Functions::VALUE(); } /** * SEARCHINSENSITIVE. * * @param string $needle The string to look for * @param string $haystack The string in which to look * @param int $offset Offset within $haystack * * @return string */ public static function SEARCHINSENSITIVE($needle, $haystack, $offset = 1) { $needle = Functions::flattenSingleValue($needle); $haystack = Functions::flattenSingleValue($haystack); $offset = Functions::flattenSingleValue($offset); if (!is_bool($needle)) { if (is_bool($haystack)) { $haystack = ($haystack) ? \PhpOffice\PhpSpreadsheet\Calculation::getTRUE() : \PhpOffice\PhpSpreadsheet\Calculation::getFALSE(); } if (($offset > 0) && (\PhpOffice\PhpSpreadsheet\Shared\StringHelper::countCharacters($haystack) > $offset)) { if (\PhpOffice\PhpSpreadsheet\Shared\StringHelper::countCharacters($needle) == 0) { return $offset; } if (function_exists('mb_stripos')) { $pos = mb_stripos($haystack, $needle, --$offset, 'UTF-8'); } else { $pos = stripos($haystack, $needle, --$offset); } if ($pos !== false) { return ++$pos; } } } return Functions::VALUE(); } /** * FIXEDFORMAT. * * @param mixed $value Value to check * @param int $decimals * @param bool $no_commas * * @return string */ public static function FIXEDFORMAT($value, $decimals = 2, $no_commas = false) { $value = Functions::flattenSingleValue($value); $decimals = Functions::flattenSingleValue($decimals); $no_commas = Functions::flattenSingleValue($no_commas); // Validate parameters if (!is_numeric($value) || !is_numeric($decimals)) { return Functions::NAN(); } $decimals = floor($decimals); $valueResult = round($value, $decimals); if ($decimals < 0) { $decimals = 0; } if (!$no_commas) { $valueResult = number_format($valueResult, $decimals); } return (string) $valueResult; } /** * LEFT. * * @param string $value Value * @param int $chars Number of characters * * @return string */ public static function LEFT($value = '', $chars = 1) { $value = Functions::flattenSingleValue($value); $chars = Functions::flattenSingleValue($chars); if ($chars < 0) { return Functions::VALUE(); } if (is_bool($value)) { $value = ($value) ? \PhpOffice\PhpSpreadsheet\Calculation::getTRUE() : \PhpOffice\PhpSpreadsheet\Calculation::getFALSE(); } if (function_exists('mb_substr')) { return mb_substr($value, 0, $chars, 'UTF-8'); } return substr($value, 0, $chars); } /** * MID. * * @param string $value Value * @param int $start Start character * @param int $chars Number of characters * * @return string */ public static function MID($value = '', $start = 1, $chars = null) { $value = Functions::flattenSingleValue($value); $start = Functions::flattenSingleValue($start); $chars = Functions::flattenSingleValue($chars); if (($start < 1) || ($chars < 0)) { return Functions::VALUE(); } if (is_bool($value)) { $value = ($value) ? \PhpOffice\PhpSpreadsheet\Calculation::getTRUE() : \PhpOffice\PhpSpreadsheet\Calculation::getFALSE(); } if (empty($chars)) { return ''; } if (function_exists('mb_substr')) { return mb_substr($value, --$start, $chars, 'UTF-8'); } return substr($value, --$start, $chars); } /** * RIGHT. * * @param string $value Value * @param int $chars Number of characters * * @return string */ public static function RIGHT($value = '', $chars = 1) { $value = Functions::flattenSingleValue($value); $chars = Functions::flattenSingleValue($chars); if ($chars < 0) { return Functions::VALUE(); } if (is_bool($value)) { $value = ($value) ? \PhpOffice\PhpSpreadsheet\Calculation::getTRUE() : \PhpOffice\PhpSpreadsheet\Calculation::getFALSE(); } if ((function_exists('mb_substr')) && (function_exists('mb_strlen'))) { return mb_substr($value, mb_strlen($value, 'UTF-8') - $chars, $chars, 'UTF-8'); } return substr($value, strlen($value) - $chars); } /** * STRINGLENGTH. * * @param string $value Value * * @return int */ public static function STRINGLENGTH($value = '') { $value = Functions::flattenSingleValue($value); if (is_bool($value)) { $value = ($value) ? \PhpOffice\PhpSpreadsheet\Calculation::getTRUE() : \PhpOffice\PhpSpreadsheet\Calculation::getFALSE(); } if (function_exists('mb_strlen')) { return mb_strlen($value, 'UTF-8'); } return strlen($value); } /** * LOWERCASE. * * Converts a string value to upper case. * * @param string $mixedCaseString * * @return string */ public static function LOWERCASE($mixedCaseString) { $mixedCaseString = Functions::flattenSingleValue($mixedCaseString); if (is_bool($mixedCaseString)) { $mixedCaseString = ($mixedCaseString) ? \PhpOffice\PhpSpreadsheet\Calculation::getTRUE() : \PhpOffice\PhpSpreadsheet\Calculation::getFALSE(); } return \PhpOffice\PhpSpreadsheet\Shared\StringHelper::strToLower($mixedCaseString); } /** * UPPERCASE. * * Converts a string value to upper case. * * @param string $mixedCaseString * * @return string */ public static function UPPERCASE($mixedCaseString) { $mixedCaseString = Functions::flattenSingleValue($mixedCaseString); if (is_bool($mixedCaseString)) { $mixedCaseString = ($mixedCaseString) ? \PhpOffice\PhpSpreadsheet\Calculation::getTRUE() : \PhpOffice\PhpSpreadsheet\Calculation::getFALSE(); } return \PhpOffice\PhpSpreadsheet\Shared\StringHelper::strToUpper($mixedCaseString); } /** * PROPERCASE. * * Converts a string value to upper case. * * @param string $mixedCaseString * * @return string */ public static function PROPERCASE($mixedCaseString) { $mixedCaseString = Functions::flattenSingleValue($mixedCaseString); if (is_bool($mixedCaseString)) { $mixedCaseString = ($mixedCaseString) ? \PhpOffice\PhpSpreadsheet\Calculation::getTRUE() : \PhpOffice\PhpSpreadsheet\Calculation::getFALSE(); } return \PhpOffice\PhpSpreadsheet\Shared\StringHelper::strToTitle($mixedCaseString); } /** * REPLACE. * * @param string $oldText String to modify * @param int $start Start character * @param int $chars Number of characters * @param string $newText String to replace in defined position * * @return string */ public static function REPLACE($oldText, $start, $chars, $newText) { $oldText = Functions::flattenSingleValue($oldText); $start = Functions::flattenSingleValue($start); $chars = Functions::flattenSingleValue($chars); $newText = Functions::flattenSingleValue($newText); $left = self::LEFT($oldText, $start - 1); $right = self::RIGHT($oldText, self::STRINGLENGTH($oldText) - ($start + $chars) + 1); return $left . $newText . $right; } /** * SUBSTITUTE. * * @param string $text Value * @param string $fromText From Value * @param string $toText To Value * @param int $instance Instance Number * * @return string */ public static function SUBSTITUTE($text = '', $fromText = '', $toText = '', $instance = 0) { $text = Functions::flattenSingleValue($text); $fromText = Functions::flattenSingleValue($fromText); $toText = Functions::flattenSingleValue($toText); $instance = floor(Functions::flattenSingleValue($instance)); if ($instance == 0) { if (function_exists('mb_str_replace')) { return mb_str_replace($fromText, $toText, $text); } return str_replace($fromText, $toText, $text); } $pos = -1; while ($instance > 0) { if (function_exists('mb_strpos')) { $pos = mb_strpos($text, $fromText, $pos + 1, 'UTF-8'); } else { $pos = strpos($text, $fromText, $pos + 1); } if ($pos === false) { break; } --$instance; } if ($pos !== false) { if (function_exists('mb_strlen')) { return self::REPLACE($text, ++$pos, mb_strlen($fromText, 'UTF-8'), $toText); } return self::REPLACE($text, ++$pos, strlen($fromText), $toText); } return $text; } /** * RETURNSTRING. * * @param mixed $testValue Value to check * * @return string|null */ public static function RETURNSTRING($testValue = '') { $testValue = Functions::flattenSingleValue($testValue); if (is_string($testValue)) { return $testValue; } return null; } /** * TEXTFORMAT. * * @param mixed $value Value to check * @param string $format Format mask to use * * @return string */ public static function TEXTFORMAT($value, $format) { $value = Functions::flattenSingleValue($value); $format = Functions::flattenSingleValue($format); if ((is_string($value)) && (!is_numeric($value)) && \PhpOffice\PhpSpreadsheet\Shared\Date::isDateTimeFormatCode($format)) { $value = DateTime::DATEVALUE($value); } return (string) \PhpOffice\PhpSpreadsheet\Style\NumberFormat::toFormattedString($value, $format); } /** * VALUE. * * @param mixed $value Value to check * * @return bool */ public static function VALUE($value = '') { $value = Functions::flattenSingleValue($value); if (!is_numeric($value)) { $numberValue = str_replace( \PhpOffice\PhpSpreadsheet\Shared\StringHelper::getThousandsSeparator(), '', trim($value, " \t\n\r\0\x0B" . \PhpOffice\PhpSpreadsheet\Shared\StringHelper::getCurrencyCode()) ); if (is_numeric($numberValue)) { return (float) $numberValue; } $dateSetting = Functions::getReturnDateType(); Functions::setReturnDateType(Functions::RETURNDATE_EXCEL); if (strpos($value, ':') !== false) { $timeValue = DateTime::TIMEVALUE($value); if ($timeValue !== Functions::VALUE()) { Functions::setReturnDateType($dateSetting); return $timeValue; } } $dateValue = DateTime::DATEVALUE($value); if ($dateValue !== Functions::VALUE()) { Functions::setReturnDateType($dateSetting); return $dateValue; } Functions::setReturnDateType($dateSetting); return Functions::VALUE(); } return (float) $value; } }