sixteenstudio/mathematician

A layer on top of BCMath that deals with fractional calculations

Mathematician

A layer on top of BCMath that deals with fractional calculations, _(*1)

Requirements

The BCMath PHP extension needs to be required in order for this to work., _(*2)

This package has been developed for PHP 7.0^, _(*3)

Usage

Instead of using standard BCMath functions such as bcadd and bcsub, use the math_ functions provided within the package., _(*4)

math_add($leftOperand, $rightOperand, $scale): Sixteenstudio\Mathematician\Number, _(*5)

math_sub($leftOperand, $rightOperand, $scale): Sixteenstudio\Mathematician\Number, _(*6)

math_mul($leftOperand, $rightOperand, $scale): Sixteenstudio\Mathematician\Number, _(*7)

math_div($leftOperand, $rightOperand, $scale): Sixteenstudio\Mathematician\Number, _(*8)

These functions return an instance of Sixteenstudio\Mathematician\Number, unlike BCMath which returns a string representation of the decimal result of the calculation., _(*9)

This allows us to do some neat things like represent certain operations as fractions, which in turn allows us to do things like this far more accurately than the likes of standard float logic or BCMath can handle:, _(*10)

(1 / 3) * 3 // Equates to 0.9999999999813, _(*11)

bcmul(bcdiv(1, 3, 20), 3, 20) // Equates to 0.99999999999999999997, _(*12)

math_mul(math_div(1, 3, 20), 3, 20) // Equates to 1.00000000000000000000, _(*13)

If you'd prefer not to use the helpers, you can insantiate the Sixteenstudio\Mathematician\Mathematician class and use the respective functions directly like so:, _(*14)

<?php

$mathematician = new \Sixteenstudio\Mathematician\Mathematician();

$addition = $mathematician->add(1, 5, 20);
$subtraction = $mathematician->subtract(1, 5, 20);
$multiplication = $mathematician->multiply(1, 5, 20);
$division = $mathematician->divide(1, 5, 20);