Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/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.
https://github.com/krowinski/bcmath-extended

abs arbitrary-precision bignumber ceil complex-numbers composer-packages deche decimals floor math money php rand scientific-notation

Last synced: 1 day ago
JSON representation

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

Host: GitHub
URL: https://github.com/krowinski/bcmath-extended
Owner: krowinski
License: mit
Created: 2016-03-20T20:27:51.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2023-01-25T21:38:04.000Z (almost 2 years ago)
Last Synced: 2024-08-08T15:05:46.406Z (3 months ago)
Topics: abs, arbitrary-precision, bignumber, ceil, complex-numbers, composer-packages, deche, decimals, floor, math, money, php, rand, scientific-notation
Language: PHP
Homepage:
Size: 118 KB
Stars: 74
Watchers: 6
Forks: 12
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        # 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 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

===

```sh

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.