### Description

Moontoast\Math is useful for working with integers that are larger than
(or may become larger than, through mathematical computations) PHP's max
integer value for a given system. On 64-bit systems, this number is
9223372036854775807. On 32-bit systems, it is 2147483647. When overflowing
this boundary, PHP turns the number into a float, reducing precision (see
the PHP manual entry for Integers).

Moontoast\Math provides an easy-to-use wrapper around the bcmath extension,
allowing one to perform mathematical calculations on numeric strings,
going well outside the integer range of the system and maintaining arbitrary
precision for more precise calculations.

See the docs/ directory for generated API documentation.

Moontoast\Math requires PHP 5.3+ and the bcmath extension.

**Monthly Downloads**: 0

**Programming language**: JavaScript

**License**: Apache License 2.0

**Latest version**: v1.1.0

## Math alternatives and similar libraries

Based on the "Numbers" category

** Code Quality Rankings and insights are calculated and provided by Lumnify.*

*They vary from L1 to L5 with "L5" being the highest. Visit our partner's website for more details.*

*Do you think we are missing an alternative of Math or a related project?*

## README

## Moontoast Math Library

Moontoast\Math is useful for working with integers that are larger than (or may become larger than, through mathematical computations) PHP's max integer value for a given system. On 64-bit systems, this number is

- On 32-bit systems, it is 2147483647. When overflowing this boundary, PHP turns the number into a float, reducing precision (see the PHP manual entry for Integers).

Moontoast\Math provides an easy-to-use wrapper around the bcmath extension, allowing one to perform mathematical calculations on numeric strings, going well outside the integer range of the system and maintaining arbitrary precision for more precise calculations.

See the `docs/`

directory for generated API documentation.

Moontoast\Math requires PHP 5.3+ and the bcmath extension.

## Installation

The preferred method of installation is via Packagist, as this provides
the PSR-0 autoloader functionality. The following `composer.json`

will download
and install the latest version of the Moontoast\Math library into your project:

```
{
"require": {
"moontoast/math": "*"
}
}
```

## Examples

```
$bn = new \Moontoast\Math\BigNumber('9,223,372,036,854,775,808');
$bn->multiply(35);
var_dump($bn->getValue());
var_dump($bn->convertToBase(16));
```

This produces the following output:

```
string(21) "322818021289917153280"
string(18) "118000000000000000"
```

You might want to use BigNumber to work with a UUID, which is an unsigned 128-bit integer. For example:

```
$uuid = \Moontoast\Math\BigNumber::convertToBase10('ff6f8cb0c57d11e19b210800200c9a66', 16);
```

This utility converts the UUID from hexadecimal (base 16) representation to a string representation of the unsigned 128-bit integer in decimal (base 10). You may now create a BigNumber object with it to perform calculations, if you wish.

```
$bn = new \Moontoast\Math\BigNumber($uuid);
echo $bn; // 339532337419071774305803111643925486182
```

## License

Copyright © 2013 Moontoast, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

*
*Note that all licence references and agreements mentioned in the Math README section above
are relevant to that project's source code only.
*