class.ilMath.php

Go to the documentation of this file.

<?php

class ilMath
{
    protected static ?ilMathAdapter $default_adapter = null;

    public static function _add($left_operand, $right_operand, int $scale = 50)
    {
        return static::getDefaultAdapter()->add($left_operand, $right_operand, $scale);
    }

    public static function _div($left_operand, $right_operand, int $scale = 50)
    {
        return static::getDefaultAdapter()->div($left_operand, $right_operand, $scale);
    }

    public static function _mod($operand, $modulu): int
    {
        return static::getDefaultAdapter()->mod($operand, $modulu);
    }

    public static function _mul($left_operand, $right_operand, int $scale = 50)
    {
        return static::getDefaultAdapter()->mul($left_operand, $right_operand, $scale);
    }

    public static function _pow($left_operand, $right_operand, int $scale = 50)
    {
        return static::getDefaultAdapter()->pow($left_operand, $right_operand, $scale);
    }

    public static function _sqrt($operand, int $scale = 50)
    {
        return static::getDefaultAdapter()->sqrt($operand, $scale);
    }

    public static function _sub($left_operand, $right_operand, int $scale = 50)
    {
        return static::getDefaultAdapter()->sub($left_operand, $right_operand, $scale);
    }

    public static function isCoprimeFraction($numerator, $denominator): bool
    {
        $gcd = self::getGreatestCommonDivisor(abs($numerator), abs($denominator));

        return $gcd == 1;
    }

    public static function getGreatestCommonDivisor($a, $b)
    {
        if ($b > 0) {
            return self::getGreatestCommonDivisor($b, $a % $b);
        }

        return $a;
    }

    public static function setDefaultAdapter(ilMathAdapter $adapter): void
    {
        static::$default_adapter = $adapter;
    }

    public static function getDefaultAdapter(): ilMathAdapter
    {
        if (null === static::$default_adapter) {
            static::$default_adapter = static::getFirstValidAdapter();
        }

        return static::$default_adapter;
    }

    public static function getInstance(string $adapter = null): \ilMathAdapter
    {
        if (null === $adapter) {
            return static::getFirstValidAdapter();
        }

        $class_name = 'ilMath' . $adapter . 'Adapter';
        $path_to_class = realpath('Services/Math/classes/class.' . $class_name . '.php');

        if (!is_file($path_to_class) || !is_readable($path_to_class)) {
            throw new ilMathException(sprintf(
                'The math adapter %s is not valid, please refer to a class implementing %s',
                $adapter,
                ilMathAdapter::class
            ));
        }
        if (!class_exists($class_name) || !is_subclass_of($class_name, ilMathAdapter::class)) {
            throw new ilMathException(sprintf(
                'The math adapter class %s is not valid, please refer to a class implementing %s',
                $class_name,
                ilMathAdapter::class
            ));
        }

        return new $class_name();
    }

    public static function getFirstValidAdapter(): ilMathAdapter
    {
        if (extension_loaded('bcmath')) {
            return static::getInstance('BCMath');
        }

        return static::getInstance('Php');
    }

    public static function __callStatic(string $method, $args)
    {
        if (strpos($method, '_') === 0) {
            $method = substr($method, 1);
        }

        $adapter = static::getDefaultAdapter();

        return call_user_func_array([$adapter, $method], $args);
    }
}