Download the PHP package degecko/super-number without Composer

SuperNumber

SuperNumber is a number objectifier. Its purpose is to keep simple math OOP friendly. If you're looking for a way to clean up your views, this will do the job.

To use it, you can use it via composer:

Then, simply initialize it on any number:

If you need to initialize it multiple times, I recommend creating a helper, like the following:

Available Methods

Simple Math

• add() / plus() to perform addition
• subtract() / sub() / minus() to perform subtraction
• multiply() / times() to perform multiplication
• divide() / over() to perform division

All of the above support 2 parameters. The first is the value that you want to use with the current number, and the second parametere specifies if that value should be treated as a percentage.

E.g.

Of course, you can chain them together:

Apart from those, there are other basic methods:

• increment() / decrement() which are aliases of add(1) and subtract(1). You can specify a different value by passing it as the first parameter.
• power() / pow() to raise to a power
• modulo() / mod() to perform modulo

E.g.

Formulas

• percentageOf() / percentOf() computes the percentage of the current number from the given value.
• percentageFrom() / percentFrom() computes what percentage of the given number represents the current number.

E.g.

Mutators

• mutate(callable $fn) will let you alter the currently stored number any way you want, by passing it a callable function. The first parameter of the function is the current $value. Whatever you return, will become the new number.

Warning! This does not validate your new value to be numeric.

E.g.

Output

The magic method __toString() will return (string) $this->number;, so there's no need to call another method to get the output of a current SuperNumber object. However, there are additional methods to get the output, if required.

• get() which returns the current number, uncasted.
• printf($pattern, ...$arguments) which allows you to use sprintf() on the current number. It automatically adds the second sprintf parameter to be the current value.
• format($decimals = 0, $decPoint = '.', $thousandsSep = ',') which is an alias of number_format. It supports the same parameters as number_format.

Castings

• toInt() will cast the current value to an integer
• toFloat() will cast the current value to a float

Checks

• isOdd() checks if the integer version of the current number is odd.
• isEven() checks if the integer version of the current number is even.
• eq() / equal() / equals() checks if the current value is equal to the provided value.
• lt() / lessThan() checks if the current value is less than the provided value.
• lte() / lessThanOrEqual() checks if the current value is less than or equal to the provided value.
• gt() / greaterThan() checks if the current value is greater than the provided value.
• gte() / greaterThanOrEqual() checks if the current value is greater than or equal to the provided value.

And, also all of the PHP math functions are supported and can be chained together:

• abs()
• acos()
• acosh()
• asin()
• asinh()
• atan()
• atanh()
• ceil()
• cos()
• cosh()
• deg2rad()
• exp()
• expm1()
• floor()
• fmod()
• log10()
• log1p()
• log()
• min()
• max()
• rad2deg()
• round()
• sin()
• sinh()
• sqrt()
• tan()
• tanh()
• base_convert()
• bindec()
• decbin()
• dechex()
• decoct()
• hexdec()
• octdec()
• pow()

E.g.

You can find those defined in the official PHP documentation.

Author

Cosmin Gheorghita (degecko.com)