Decimal

The Decimal class has been created to make easier handling large numbers inside financial applications without precision loss.

Import

To import the Decimal class, you must add the following line in the header of your PHP script:

use \Litipk\BigNumbers\Decimal as Decimal;

The Decimal class provides many static constructors.

The most generic constructor, but also the slowest one.

Decimal::create($value, $scale=null)

$value : Any PHP native variable that represents a number.
$scale : The precision we want (measured in number of digits behind the fixed point).

Decimal::fromInteger($intValue, $scale=null)

Decimal::fromFloat($fltValue, $scale=null)

Decimal::fromString($strValue, $scale=null)

Constructs a new Decimal object based on a previous one, but changing it's $scale property.

Decimal::fromDecimal(Decimal $b, $scale=null)

Remember that all Decimal objects are immutable, all operators return new instances rather than modify the object that called the method.

// c = a + b
$c = $a->add($b, $scale); // $a and $b are Decimal objects. $scale is optional.

// c = a - b
$c = $a->sub($b, $scale); // $a and $b are Decimal objects. $scale is optional.

// c = a · b
$c = $a->mul($b); // $a and $b are Decimal objects. $scale is optional.

// c = a / b
$c = $a->div($b); // $a and $b are Decimal objects. $scale is optional.

// c = a^b
$c = $a->pow($b); // $a and $b are Decimal objects. $scale is optional.