MAN page from Old RedHat 5.X perl-5.004-4.i386.rpm

Math::BigInt

Section: Perl Programmers Reference Guide (3)
Updated: perl 5.004, patch 04
Index

NAME

Math::BigInt - Arbitrary size integer math package

SYNOPSIS

  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,<0,=0,>0)  $i->badd(BINT) return BINT         addition  $i->bsub(BINT) return BINT         subtraction  $i->bmul(BINT) return BINT         multiplication  $i->bdiv(BINT) return (BINT,BINT)  division (quo,rem) just quo if scalar  $i->bmod(BINT) return BINT         modulus  $i->bgcd(BINT) return BINT         greatest common divisor  $i->bnorm return BINT              normalization

DESCRIPTION

All basic math operations are overloaded if you declare your bigintegers as

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

Canonical notation: Big integer value are strings of the form /^[+-]\d+$/ with leadingzeros 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 arraywhose 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'

BUGS

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

AUTHOR

Mark Biggar, overloaded interface by Ilya Zakharevich.

This document was created byman2html,using the manual pages.