<?php
/**
* Immutable class for handling numbers with precision.
*
* Never change the $number or the $precision after the creation of the object.
*/
class DecimalNumber {
private $precision;
private $number;
/**
* Get an instance given a string and a precision
* @param string $string The decimal number in string form
* @param int $precision The precision of the number
* @return DecimalNumber Return new instance
*/
public static function get($string, $precision = 4) {
$me = get_called_class();
$number = new $me;
$number->precision = $precision;
$number->number = bcadd($string, '0', $precision);
return $number;
}
/**
* Add a formal entry point for decimal numbers
* @param DecimalNumber $number Decimal number to base off of
* @param integer $precision new precision
* @return DecimalNumber DecimalNumber with new precision
*/
public static function decimalNumber(DecimalNumber $number, $precision = 4) {
return static::get($number, $precision);
}
/**
* Perform an addition operation
* @param DecimalNumber $number Addend
* @return DecimalNumber Sum
*/
public function sum(DecimalNumber $number) {
return DecimalNumber::string(bcadd($this->number, $number, $this->precision));
}
/**
* Perform a subtraction operation
* @param DecimalNumber $number Addend
* @return DecimalNumber Sum
*/
public function difference(DecimalNumber $number) {
return DecimalNumber::string(bcsub($this->number, $number, $this->precision));
}
/**
* Perform a multiplication operation
* @param DecimalNumber $number Multiplier
* @return DecimalNumber Product
*/
public function product(DecimalNumber $number) {
return DecimalNumber::string(bcmul($this->number, $number, $this->precision));
}
/**
* Perform a division operation
* @param DecimalNumber $number Divisor
* @return DecimalNumber Quotient
*/
public function quotient(DecimalNumber $number) {
return DecimalNumber::string(bcdiv($this->number, $number, $this->precision));
}
public function floor() {
return bcadd(bcadd($this->number, '0'), '0', $this->precision);
}
/**
* Automagically convert to a string
* @return string returns a string containing the value of this DecimalNumber
*/
public function __toString() {
return $this->number;
}
}
$d = DecimalNumber::string('4.7');
$c = $d->sum(DecimalNumber::string('2.1'));
echo $c->floored();
Output for git.master, git.master_jit, rfc.property-hooks
Fatal error: Uncaught Error: Call to undefined method DecimalNumber::string() in /in/9vGKt:88
Stack trace:
#0 {main}
thrown in /in/9vGKt on line 88
Process exited with code 255.
This tab shows result from various feature-branches currently under review by the php developers. Contact me to have additional branches featured.