MathUtility.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Core\Utility;

class MathUtility {

    static public function forceIntegerInRange($theInt, $min, $max = 2000000000, $defaultValue = 0) {
        // Returns $theInt as an integer in the integerspace from $min to $max
        $theInt = (int)$theInt;
        // If the input value is zero after being converted to integer,
        // defaultValue may set another default value for it.
        if ($defaultValue && !$theInt) {
            $theInt = $defaultValue;
        }
        if ($theInt < $min) {
            $theInt = $min;
        }
        if ($theInt > $max) {
            $theInt = $max;
        }
        return $theInt;
    }

    static public function convertToPositiveInteger($theInt) {
        $theInt = (int)$theInt;
        if ($theInt < 0) {
            $theInt = 0;
        }
        return $theInt;
    }

    static public function canBeInterpretedAsInteger($var) {
        if ($var === '' || is_object($var) || is_array($var)) {
            return FALSE;
        }
        return (string) (int)$var === (string) $var;
    }

    static public function canBeInterpretedAsFloat($var) {
        $pattern_lnum = '[0-9]+';
        $pattern_dnum = '([0-9]*[\.]' . $pattern_lnum . ')|(' . $pattern_lnum . '[\.][0-9]*)';
        $pattern_exp_dnum = '[+-]?((' . $pattern_lnum . '|' . $pattern_dnum . ')([eE][+-]?' . $pattern_lnum . ')?)';

        if ($var === '' || is_object($var) || is_array($var)) {
            return FALSE;
        }

        $matches = preg_match('/^' . $pattern_exp_dnum . '$/', $var);
        return $matches === 1;
    }

    static public function calculateWithPriorityToAdditionAndSubtraction($string) {
        // Removing all whitespace
        $string = preg_replace('/[[:space:]]*/', '', $string);
        // Ensuring an operator for the first entrance
        $string = '+' . $string;
        $qm = '\\*\\/\\+-^%';
        $regex = '([' . $qm . '])([' . $qm . ']?[0-9\\.]*)';
        // Split the expression here:
        $reg = array();
        preg_match_all('/' . $regex . '/', $string, $reg);
        reset($reg[2]);
        $number = 0;
        $Msign = '+';
        $err = '';
        $buffer = doubleval(current($reg[2]));
        // Advance pointer
        next($reg[2]);
        while (list($k, $v) = each($reg[2])) {
            $v = doubleval($v);
            $sign = $reg[1][$k];
            if ($sign == '+' || $sign == '-') {
                $Msign == '-' ? ($number -= $buffer) : ($number += $buffer);
                $Msign = $sign;
                $buffer = $v;
            } else {
                if ($sign == '/') {
                    if ($v) {
                        $buffer /= $v;
                    } else {
                        $err = 'dividing by zero';
                    }
                }
                if ($sign == '%') {
                    if ($v) {
                        $buffer %= $v;
                    } else {
                        $err = 'dividing by zero';
                    }
                }
                if ($sign == '*') {
                    $buffer *= $v;
                }
                if ($sign == '^') {
                    $buffer = pow($buffer, $v);
                }
            }
        }
        $number = $Msign == '-' ? ($number -= $buffer) : ($number += $buffer);
        return $err ? 'ERROR: ' . $err : $number;
    }

    static public function calculateWithParentheses($string) {
        $securC = 100;
        do {
            $valueLenO = strcspn($string, '(');
            $valueLenC = strcspn($string, ')');
            if ($valueLenC == strlen($string) || $valueLenC < $valueLenO) {
                $value = self::calculateWithPriorityToAdditionAndSubtraction(substr($string, 0, $valueLenC));
                $string = $value . substr($string, ($valueLenC + 1));
                return $string;
            } else {
                $string = substr($string, 0, $valueLenO) . self::calculateWithParentheses(substr($string, ($valueLenO + 1)));
            }
            // Security:
            $securC--;
            if ($securC <= 0) {
                break;
            }
        } while ($valueLenO < strlen($string));
        return $string;
    }

    static public function isIntegerInRange($value, $minimum, $maximum) {
        $value = filter_var($value, FILTER_VALIDATE_INT, array(
            'options' => array(
                'min_range' => $minimum,
                'max_range' => $maximum
            )
        ));
        $isInRange = is_int($value);
        return $isInRange;
    }

}