bcmath-extended

KO | EN

gitlite — search

#dotfiles #android #ruby #api #java #python #node #server #csharp #boilerplate #typescript #android-application

bcmath-extended

★ 79 Open GitHub ↗

Extends php BCMath lib for missing functions like floor, ceil, round, abs, min, max, rand for big numbers. Also wraps existing BCMath functions.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# bcmath-extended
[![PHP Tests](https://github.com/krowinski/bcmath-extended/actions/workflows/tests.yml/badge.svg)](https://github.com/krowinski/bcmath-extended/actions/workflows/tests.yml)
[![Code Coverage](https://raw.githubusercontent.com/krowinski/bcmath-extended/master/badge-coverage.svg)](https://github.com/krowinski/bcmath-extended/actions)
[![Latest Stable Version](https://poser.pugx.org/krowinski/bcmath-extended/v/stable)](https://packagist.org/packages/krowinski/bcmath-extended)
[![Total Downloads](https://poser.pugx.org/krowinski/bcmath-extended/downloads)](https://packagist.org/packages/krowinski/bcmath-extended)
[![License](https://poser.pugx.org/krowinski/bcmath-extended/license)](https://packagist.org/packages/krowinski/bcmath-extended)

Extends php BCMath lib for missing functions like abs, min, max, rand, fact, log for big numbers.
Handles scientific notation like 1.0E+35 to be used with BCMath.
Also wraps existing BCMath functions. (more http://php.net/manual/en/book.bc.php)

Installation
===

```sh
composer require krowinski/bcmath-extended
```

Features
===
- config
    - setTrimTrailingZeroes - disable|enable trailing zeros (default trimming is enabled)  
- new tool methods
  - convertToNumber - converts scientific notation, string and int to [BcMath\Number](https://www.php.net/manual/en/class.bcmath-number.php)
    - getScale - gets current global scale 
    - getDecimalsLengthFromNumber - gets amount of decimals 
    - hexdec - converting from hexadecimal to decimal
    - dechex - converting from decimal to hexadecimal
    - bin2dec - converting from binary to decimal
    - dec2bin - converting from decimal to binary
- new math functions 
    - round
    - abs 
    - rand
    - max
    - min
    - roundDown
    - roundUp
    - roundHalfEven
    - ceil
    - exp
    - log
    - fact
    - pow (supports fractional)
  - mod (supports fractional + scale)
    - bitwise operators
        - bitXor
        - bitOr
        - bitAnd
- proxy for [original functions](https://www.php.net/manual/en/book.bc.php)
- all functions supports scientific notation
- all functions are static, so it can be easily replaced by this lib

Info
===
As of 7.2 float can be passed to bcmod, but they don't return correct values (IMO)

I created bug for this in https://bugs.php.net/bug.php?id=76287, but it was commented as documentation issue not a bug.

```
bcmod() doesn't use floor() but rather truncates towards zero,
which is also defined this way for POSIX fmod(), so that the
result always has the same sign as the dividend.  Therefore, this
is not a bug, but rather a documentation issue.
```

But I still will use floor not truncated for mod in this lib.

bcmath-extended

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README