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...

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... 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.

References exp2dec().

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

     {
         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;
     }

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.

References ilMathAdapter\comp().

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

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.

References string.

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

     {
         // 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;
         }
     }

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.

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

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

     {
         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;
     }

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()