Download the PHP package marcoconsiglio/bcmath-extended without Composer
On this page you can find all versions of the php package marcoconsiglio/bcmath-extended. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download marcoconsiglio/bcmath-extended
More information about marcoconsiglio/bcmath-extended
Files in marcoconsiglio/bcmath-extended
Package bcmath-extended
Short Description The BCMathExtended library extends the PHP BCMath extension adding more features like abs, min, max, random, factorial, type comparison between integer and decimal or positive and negative, modulo and power modulo with negative modulus (see more on BCMath extendsion http://php.net/manual/en/book.bc.php).
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package bcmath-extended
?label=Line%20coverage&labelColor=rgb(255%2C255%2C255)){kind=icon}
?label=Branch%20coverage&labelColor=rgb(255%2C255%2C255)){kind=icon}
?label=Path%20coverage&labelColor=rgb(255%2C255%2C255)){kind=icon}
bcmath-extended
This PHP library extends the BCMath PHP estension. Since the class BCMath\Number is a final class, this library extends through composition with a child class (Number).
It was inspired by krowinski/bcmath-extended.
Index
- Installation
- Features
- Input types
- Notes
- API documentation
Installation
Features
Base features
The following list of features of the Number class are the same as those found in BCMath\Number:
- Base instance
$value - Base instance
$scale - Addition
- Subtracion
- Multiplication
- Division
- Exponentiation
- Square root
- Ceil
- Floor
- Round
- Cast to
stringtype
Missing base features
These are the missing features:
- Spaceship comparison
- Comparison operator overloading
- Serialization/unserialization
Added features
This list consists of the new features added in this library:
floattype input **- Cast to
floattype ** - Cast to
inttype - Modulo *
- Power & modulo *
- Division & modulo *
- Absolute
- Min
- Max
- Random
- Equal comparison
- Different comparison
- Greater than comparison
- Greater than or equal comparison
- Less than comparison
- Less than or equal comparison
- In range comparison
- In range min excluded comparison
- In range max excluded comparison
- In range both extremes excluded comparison
- Convert to radian
- Convert to degree
- Opposite sign
Input types
This is the input types set available:
intstringfloat**BCMath\NumberMarcoConsiglio\BCMathExtended\Number
String numeric format
- Only decimal separator
.is allowed. - Thousand separator is not supported.
- Scientific notation is not supported (use
Number::string()method to cast very big or smallfloatnumbers to numericstringwithout scientific notation).
For example "1234567.89" is allowed while "1,234,567.89" is not.
Notes
* Consideration on modulo operation
As already pointed by krowinsky in PHP issue #76287
the modulo operation in BCMath extension is not correct in case the modulus is negative. Therefore in this library the following formula is used:
$$ a \pmod n = a - n \times \left \lfloor {\dfrac{a}{n}} \right \rfloor $$
With this formula a negative modulus $n$ is allowed.
** Consideration on float type
If you need to convert a float to Number and back, prepare for the worst.
Keep in mind that floating point arithmetic is full of hidden flaws, that's why aribtrary arithmetic is needed (in this case implemented by BcMath PHP extension).
While this library accept a float type input, it is not recommended to cast a Number instance to float, otherwise nasty things could happen.
Use this library only for end calculations, like print a report. If other subsystem of your software need float type inputs, it is strongly advised to avoid this library for intermediate calculations.
API documentation
You can find the API documentation at docs/html/index.html.
All versions of bcmath-extended with dependencies
ext-bcmath Version *