_______   __            __       __             __      __       
|       \ |  \          |  \     /  \           |  \    |  \      
| $$$$$$$\ \$$  ______  | $$\   /  $$  ______  _| $$_   | $$____  
| $$__/ $$|  \ /      \ | $$$\ /  $$$ |      \|   $$ \  | $$    \ 
| $$    $$| $$|  $$$$$$\| $$$$\  $$$$  \$$$$$$\\$$$$$$  | $$$$$$$\
| $$$$$$$\| $$| $$  | $$| $$\$$ $$ $$ /      $$ | $$ __ | $$  | $$
| $$__/ $$| $$| $$__| $$| $$ \$$$| $$|  $$$$$$$ | $$|  \| $$  | $$
| $$    $$| $$ \$$    $$| $$  \$ | $$ \$$    $$  \$$  $$| $$  | $$
 \$$$$$$$  \$$ _\$$$$$$$ \$$      \$$  \$$$$$$$   \$$$$  \$$   \$$
              |  \__| $$                                          
               \$$    $$                                          
                \$$$$$$                                           

BigMath

A PHP library to work with big integers. This library makes use of the GMP extension and bcmath to do its calculations.

Introduction

Maybe you ara a developer of blockchain using php. Maybe you often coding encrypt and decrypt. And you fund that there is no library easy to use for big integer or high precision number in php. Now you could coding in most easy way with the BigMath!

Install

Via Composer

$ composer require bardoqi/bigmath:dev-master

Usage

    //with pecl Operator overloading extension:
    $number = BInt('8273467836243255543265432745') + BInt('2');
    //without pecl Operator overloading extension:
    $number = BInt('8273467836243255543265432745')->add(BInt('2'));

Features

This library supports the following operations:

• Big Intgeger and high precision decimal support ....Class BigInteger: using with GMP. ....Class BigDecminal: using with bcmath.

• Global type converting functions; .... You need not use 'new' operator to create new object. .... You Only need use:

     //to get a new BigInteger instance of $var; 
     BInt($var); 
     //to get a new BigDecimal instance of $var; 
     BDec($var); 

• Simple init Mothod: of(string $value)

• Support using with pecl Operator overloading extension, there are operators could be used:

Operator	Method
$o + $arg	__add($arg)
$o - $arg	__sub($arg)
$o * $arg	__mul($arg)
$o / $arg	__div($arg)
$o % $arg	__mod($arg)
$o ** $arg	__pow($arg)
$o . $arg	__concat($arg)
$o | $arg	__bw_or($arg)
$o & $arg	__bw_and($arg)
$o ^ $arg	__bw_xor($arg)
$o === $arg	__is_identical($arg)
$o !== $arg	__is_not_identical($arg)
$o == $arg	__is_equal($arg)
$o != $arg	__is_not_equal($arg)
$o < $arg	__is_smaller($arg)
$o <= $arg	__is_smaller_or_equal($arg)
$o > $arg	__is_greater($arg) *
$o >= $arg	__is_greater_or_equal($arg) *
$o <=> $arg	__cmp($arg)
++$o	__pre_inc()
$o++	__post_inc()
--$o	__pre_dec()
$o--	__post_dec()
$o = $arg	__assign($arg)
$o += $arg	__assign_add($arg)
$o -= $arg	__assign_sub($arg)
$o *= $arg	__assign_mul($arg)
$o /= $arg	__assign_div($arg)
$o %= $arg	__assign_mod($arg)
$o **= $arg	__assign_pow($arg)
$o |= $arg	__assign_bw_or($arg)
$o &= $arg	__assign_bw_and($arg)
$o ^= $arg	__assign_bw_xor($arg)

• If without pecl Operator overloading extension, there are mothods of operators could be used:

Operators	method
+	add()
-	sub(), substract()
*	mul(), multiply()
/	div(), divide()
%	mod()
**	pow(), power()
++	plus(), increment()
--	minus(), devrement
==	eq(), equals()
!=	ne(), notEquals()
===	identical()
!==	notIdentical(()
>	gt(), greaterThan()
>=	gte() greaterThanOrEqualsTo()
<	lt(), lessThan()
<=	lte(), lessThanOrEqualsTo()
<=>	cmp(), compareTo()
-	negate()
.	concat()

• Mothods for coding simple: max(); min(); even(); odd(); sign(); isOne(); isZero(); randomRange();
• Mothods of Mathematics: abs(); divideRem; powMod(); squareRoot();
  factorial(); gcd();
• Mothods for bit orpeator(Only in BigInteger) andBits(); orBits(); clearBits(); complement() invert(); setBit(); testBit(); scan0(); scan1();
• Mothods of Math Theory(Only in BigInteger) isPrime(); jacobi(); legendre(); perfectSquare() popcount(); root();
• Chain Operators support: You can just use:

    //with pecl Operator overloading extension:
    $x=($a+$b)*($c-$d);
    //without pecl Operator overloading extension:
    $x=BInt($a)->add(BInt($b))->multiply(BInt($c)->substract(BInt($d))); 		

Sample Code

    //with Operator overloading extension:
    //if sample:
    if(abs($big_g)>abs($big_m)){
        $big_g = $big_g % $big_m;
    }
    
    //while sample:
    While (rt_v!=1){
        $x = $rd_v/$rt_v;
        //...
    }
    
    //for sample:
    for($i=$xstart; $i<$xMax; $i += $step){
        $item = &$data[];
        $item['x']=$i;
    }
    
    //without Operator overloading extension:
    //if sample:
    //if(abs($big_g)>abs($big_m)){...}
    if ($big_g->abs()->gt($big_m->abs())){
        $big_g = $big_g->mod($big_m);
    }
    
    //while sample:
    //While (rt_v!=1){...}
    while (!($rt_v->isOne())){ //rt!=1
        //x=rd/rt
        $x = $rd_v->div($rt_v);
        //...
    }
    
    //for sample:
    //for($i=$xstart; $i<$xMax; $i += $step)
    for($i = BInt($xStart); $i->lt(BInt($xMax)); $i->plus($step)){
        $item = &$data[];
        $item['x']=$i;
    }
    
    //More samples please read the code in exanples! 

Change log

Please see CHANGELOG for more information what has changed recently.

Testing

$ composer test

Road Map

Add: '<<' and '>>' Operator to class BigInteger

Add: '~' Operator to class BigInteger

Add: trigonometric functions such as sin cos etc to class BigDecimal

Add: inverse trigonometric function such as asin acos etc to class BigDecimal

Add: hyperbolic trigonometric functions such as sinh cosh etc to class BigDecimal

Add: high precision math constant such as e and pi.

Add: rational number class

Contributing

Please see CONTRIBUTING and CONDUCT for details.

Security

If you discover any security related issues, please create an issue in the issue tracker.

Credits

• Bardo Qi
• All Contributors

License

The MIT License (MIT). Please see License File for more information.