Math::BigInt

See the current Perl documentation for Math::BigInt.

Here is our local, out-dated (pre-5.6) version:

Math::BigInt - Arbitrary size integer math package

  use Math::BigInt;
  $i = Math::BigInt->new($string);

  $i->bneg return BINT               negation
  $i->babs return BINT               absolute value
  $i->bcmp(BINT) return CODE         compare numbers (undef,<
    

    

All basic math operations are overloaded if you declare your big integers
as


  $i = new Math::BigInt '123 456 789 123 456 789';


Canonical notation


Big integer value are strings of the form /^[+-]\d+$/ with leading zeros suppressed.

Input


Input values to these routines may be strings of the form
/^\s*[+-]?[\d\s]+$/.

Output


Output values always always in canonical form



Actual math is done in an internal format consisting of an array whose
first element is the sign (/^[+-]$/) and whose remaining elements are base
100000 digits with the least significant digit first. The string 'NaN' is
used to represent the result when input arguments are not numbers, as well
as the result of dividing by zero.



EXAMPLES

   '+0'                            canonical zero value
   '   -123 123 123'               canonical value '-123123123'
   '1 23 456 7890'                 canonical value '+1234567890'



Autocreating constants

After use Math::BigInt ':constant' all the integer decimal constants in the given scope are converted to Math::BigInt. This conversion happens at compile time.


In particular


  perl -MMath::BigInt=:constant -e 'print 2**100'


print the integer value of 2**100. Note that without convertion of constants the expression 2**100 will be
calculatted as floating point number.



BUGS

The current version of this module is a preliminary version of the real
thing that is currently (as of perl5.002) under development.



AUTHOR

Mark Biggar, overloaded interface by Ilya Zakharevich.