This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Inheritance diagram for ilMathBaseAdapter:

Collaboration diagram for ilMathBaseAdapter:

Public Member Functions
	applyScale ($left_operand, ?int $scale=null)

	round ($value, int $precision=0)

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

Public Member Functions inherited from ilMathAdapter
	add ($left_operand, $right_operand, ?int $scale=null)
	Adds two numbers. More...

	sub ($left_operand, $right_operand, ?int $scale=null)
	Subtracts two numbers. More...

	mul ($left_operand, $right_operand, ?int $scale=null)
	Multiplies two numbers. More...

	div ($left_operand, $right_operand, ?int $scale=null)
	Divides two numbers. More...

	mod ($left_operand, $right_operand)
	Gets modulus of two numbers. More...

	pow ($left_operand, $right_operand, ?int $scale=null)
	Raises a number to another. More...

	sqrt ($operand, ?int $scale=null)
	Gets the square root of a number. More...

	comp ($left_operand, $right_operand, ?int $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)

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning Class ilMathBaseAdapter

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

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

Member Function Documentation

◆ applyScale()

ilMathBaseAdapter::applyScale	(		$left_operand,
		?int	$scale = `null`
	)

Implements ilMathAdapter.

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

References exp2dec(), and ILIAS\Repository\int().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ equals()

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

Implements ilMathAdapter.

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

References ilMathAdapter\comp().

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

Here is the call graph for this function:

◆ exp2dec()

ilMathBaseAdapter::exp2dec ( $float_str )

protected

Parameters

float | string | int $float_str

Returns: string

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

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

                                           : string
     {
         // 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 = stripos($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 {
                 throw new DomainException(
                     "Could not convert exponential notation to decimal notation: invalid float string '$float_str'"
                 );
             }
 
             // 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
             return $num_sign . '0.' . $zeros . $num;
         }
 
         // otherwise, assume already in decimal notation and return
         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 72 of file class.ilMathBaseAdapter.php.

References exp2dec(), ILIAS\Repository\int(), and null.

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

                                          : ?string
     {
         if (null === $number) {
             return null;
         }
 
         $number = trim((string) $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 *= 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,
		int	$precision = `0`
	)

Implements ilMathAdapter.

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

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

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

components/ILIAS/Math/classes/class.ilMathBaseAdapter.php

Public Member Functions

Protected Member Functions

Detailed Description

Member Function Documentation

◆ applyScale()

◆ equals()

◆ exp2dec()

◆ normalize()

◆ round()