krowinski/bcmath-extended

Extends php BCMath lib for missing functions like floor, ceil, round, abs, min, max, rand for big numbers. Also wraps existing BCMath functions. (more http://php.net/manual/en/book.bc.php) Supports scientific notations

7.0.0 2023-01-25 21:31 UTC

README

PHP Tests Code Coverage Latest Stable Version Total Downloads License

Extends php BCMath lib for missing functions like floor, ceil, round, abs, min, max, rand for big numbers. Also wraps existing BCMath functions. (more http://php.net/manual/en/book.bc.php)

Installation

composer require krowinski/bcmath-extended

Features

  • config
    • setTrimTrailingZeroes - disable|enable trailing zeros (default trimming is enabled)
  • new tool methods
    • convertScientificNotationToString - converts scientific notation to string
    • 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 in php 5.6 <)
    • bitwise operators
      • bitXor
      • bitOr
      • bitAnd
  • proxy for original functions (http://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.