Class ilMathBaseAdapter. More...

Inheritance diagram for ilMathBaseAdapter:

Collaboration diagram for ilMathBaseAdapter:

Public Member Functions

applyScale ($number, $scale=null)

This method adapts the behaviour of bcscale() More...

round ($value, $precision=0)

Parameters

mixed	$value
int	$precision

Returns: string

More...

equals ($left_operand, $right_operand, $scale=null)

{Checks whether or not two numbers are identical.

Parameters

mixed	$left_operand
mixed	$right_operand
int	$scale

Returns: bool

} More...

Public Member Functions inherited from ilMathAdapter

add ($left_operand, $right_operand, $scale=null)

Adds two numbers. More...

sub ($left_operand, $right_operand, $scale=null)

Subtracts two numbers. More...

mul ($left_operand, $right_operand, $scale=null)

Multiplies two numbers. More...

div ($left_operand, $right_operand, $scale=null)

Divides two numbers. More...

mod ($left_operand, $right_operand)

Gets modulus of two numbers. More...

pow ($left_operand, $right_operand, $scale=null)

Raises a number to another. More...

sqrt ($operand, $scale=null)

Gets the square root of a number. More...

comp ($left_operand, $right_operand, $scale=null)

Compares two numbers. More...

equals ($left_operand, $right_operand, $scale=null)

Checks whether or not two numbers are identical. More...

applyScale ($left_operand, $scale=null)

round ($value, $precision=0)

Protected Member Functions
	normalize ($number)
	This function fixes problems which occur when locale ist set to de_DE for example, because bc* function expecting strings. More...

	exp2dec ($float_str)
	Moved from ilMath... Converts numbers in the form "1.5e4" into decimal notation. More...

Detailed Description

Class ilMathBaseAdapter.

Author: Michael Jansen mjans.nosp@m.en@d.nosp@m.ataba.nosp@m.y.de

Definition at line 10 of file class.ilMathBaseAdapter.php.

Member Function Documentation

◆ applyScale()

ilMathBaseAdapter::applyScale	(	$number,
		$scale = `null`
	)

This method adapts the behaviour of bcscale()

Parameters

mixed	$number
integer	$scale

Returns: mixed

Implements ilMathAdapter.

Definition at line 18 of file class.ilMathBaseAdapter.php.

    {
        if (is_numeric($number)) {
            $scale = (int) $scale;
 
            $number = $this->exp2dec($number);
            if (strpos($number, '.') === false) {
                $number_of_decimals = 0;
            } else {
                $number_of_decimals = strlen(substr($number, strpos($number, '.') + 1));
            }
 
            if ($number_of_decimals > 0 && $number_of_decimals < $scale) {
                $number = str_pad($number, $scale - $number_of_decimals, '0');
            } elseif ($number_of_decimals > $scale) {
                $number = substr($number, 0, -($number_of_decimals - $scale));
            }
        }
 
        return $number;
    }

References exp2dec().

Referenced by ilMathPhpAdapter\add(), ilMathPhpAdapter\comp(), ilMathPhpAdapter\div(), ilMathPhpAdapter\mul(), ilMathBCMathAdapter\pow(), ilMathPhpAdapter\pow(), ilMathPhpAdapter\sqrt(), and ilMathPhpAdapter\sub().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ equals()

ilMathBaseAdapter::equals	(	$left_operand,
		$right_operand,
		$scale = `null`
	)

{Checks whether or not two numbers are identical.

Parameters

mixed	$left_operand
mixed	$right_operand
int	$scale

Returns: bool

}

Implements ilMathAdapter.

Definition at line 51 of file class.ilMathBaseAdapter.php.

    {
        return $this->comp($left_operand, $right_operand, $scale) === 0;
    }

References ilMathAdapter\comp().

Here is the call graph for this function:

◆ exp2dec()

ilMathBaseAdapter::exp2dec ( $float_str )

protected

Moved from ilMath... Converts numbers in the form "1.5e4" into decimal notation.

Author: Helmut Schottmüller helmu.nosp@m.t.sc.nosp@m.hottm.nosp@m.uell.nosp@m.er@ma.nosp@m.c.co.nosp@m.m

Definition at line 92 of file class.ilMathBaseAdapter.php.

    {
        // make sure its a standard php float string (i.e. change 0.2e+2 to 20)
        // php will automatically format floats decimally if they are within a certain range
        $original = $float_str; // store original float, so we can return a float keeping the pecision when possible
        $float_str = (string) ((float) ($float_str));
        $float_str = str_replace(",", ".", $float_str); // convert ',' to '.' (float casting was locale sensitive)
 
        // if there is an E in the float string
        if (($pos = strpos(strtolower($float_str), 'e')) !== false) {
            // get either side of the E, e.g. 1.6E+6 => exp E+6, num 1.6
            $exp = substr($float_str, $pos+1);
            $num = substr($float_str, 0, $pos);
 
            // strip off num sign, if there is one, and leave it off if its + (not required)
            if ((($num_sign = $num[0]) === '+') || ($num_sign === '-')) {
                $num = substr($num, 1);
            } else {
                $num_sign = '';
            }
            if ($num_sign === '+') {
                $num_sign = '';
            }
 
            // strip off exponential sign ('+' or '-' as in 'E+6') if there is one, otherwise throw error, e.g. E+6 => '+'
            if ((($exp_sign = $exp[0]) === '+') || ($exp_sign === '-')) {
                $exp = substr($exp, 1);
            } else {
                trigger_error("Could not convert exponential notation to decimal notation: invalid float string '$float_str'", E_USER_ERROR);
            }
 
            // get the number of decimal places to the right of the decimal point (or 0 if there is no dec point), e.g., 1.6 => 1
            $right_dec_places = (($dec_pos = strpos($num, '.')) === false) ? 0 : strlen(substr($num, $dec_pos+1));
            // get the number of decimal places to the left of the decimal point (or the length of the entire num if there is no dec point), e.g. 1.6 => 1
            $left_dec_places = ($dec_pos === false) ? strlen($num) : strlen(substr($num, 0, $dec_pos));
 
            // work out number of zeros from exp, exp sign and dec places, e.g. exp 6, exp sign +, dec places 1 => num zeros 5
            if ($exp_sign === '+') {
                $num_zeros = $exp - $right_dec_places;
            } else {
                $num_zeros = $exp - $left_dec_places;
            }
 
            // build a string with $num_zeros zeros, e.g. '0' 5 times => '00000'
            $zeros = str_pad('', $num_zeros, '0');
 
            // strip decimal from num, e.g. 1.6 => 16
            if ($dec_pos !== false) {
                $num = str_replace('.', '', $num);
            }
 
            // if positive exponent, return like 1600000
            if ($exp_sign === '+') {
                return $num_sign . $num . $zeros;
            }
            // if negative exponent, return like 0.0000016
            else {
                return $num_sign . '0.' . $zeros . $num;
            }
        }
        // otherwise, assume already in decimal notation and return
        else {
            return $original;
        }
    }

Referenced by applyScale(), normalize(), and ilMathBCMathAdapter\pow().

Here is the caller graph for this function:

◆ normalize()

ilMathBaseAdapter::normalize ( $number )

protected

This function fixes problems which occur when locale ist set to de_DE for example, because bc* function expecting strings.

Parameters

mixed $number

Returns: string

Definition at line 62 of file class.ilMathBaseAdapter.php.

    {
        if (null === $number) {
            return $number;
        }
 
        $number      = str_replace(' ', '', $number);
        $number      = $this->exp2dec($number);
        $locale_info = localeconv();
 
        if ($locale_info['decimal_point'] != '.') {
            $append             = '';
            $number_of_decimals = (int) ini_get('precision') - (int) floor(log10(abs($number)));
            if (0 > $number_of_decimals) {
                $number            *= pow(10, $number_of_decimals);
                $append             = str_repeat('0', -$number_of_decimals);
                $number_of_decimals = 0;
            }
 
            return number_format($number, $number_of_decimals, '.', '') . $append;
        }
 
        return $number;
    }

References exp2dec(), and ilMathAdapter\pow().

Referenced by ilMathBCMathAdapter\add(), ilMathPhpAdapter\add(), ilMathPhpAdapter\comp(), ilMathBCMathAdapter\div(), ilMathPhpAdapter\div(), ilMathBCMathAdapter\mod(), ilMathPhpAdapter\mod(), ilMathBCMathAdapter\mul(), ilMathPhpAdapter\mul(), ilMathBCMathAdapter\pow(), ilMathPhpAdapter\pow(), ilMathPhpAdapter\sqrt(), ilMathBCMathAdapter\sub(), and ilMathPhpAdapter\sub().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ round()

ilMathBaseAdapter::round	(	$value,
		$precision = `0`
	)

Parameters

mixed	$value
int	$precision

Returns: string

Implements ilMathAdapter.

Definition at line 43 of file class.ilMathBaseAdapter.php.

    {
        return number_format($value, $precision, '.', '');
    }

The documentation for this class was generated from the following file:

Services/Math/classes/class.ilMathBaseAdapter.php

Public Member Functions

Protected Member Functions

Detailed Description

Member Function Documentation

◆ applyScale()

◆ equals()

◆ exp2dec()

◆ normalize()

◆ round()