# Math::BigInt::FastCalc - Math::BigInt::Calc with some XS for more speed - man - [phpMan]

## NAME
    [Math::BigInt::FastCalc](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt%3A%3AFastCalc/markdown) - [Math::BigInt::Calc](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt%3A%3ACalc/markdown) with some XS for more speed

## SYNOPSIS
        # to use it with [Math::BigInt](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt/markdown)
        use [Math::BigInt](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt/markdown) lib => 'FastCalc';

        # to use it with [Math::BigFloat](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigFloat/markdown)
        use [Math::BigFloat](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigFloat/markdown) lib => 'FastCalc';

        # to use it with [Math::BigRat](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigRat/markdown)
        use [Math::BigRat](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigRat/markdown) lib => 'FastCalc';

## DESCRIPTION
    [Math::BigInt::FastCalc](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt%3A%3AFastCalc/markdown) inherits from [Math::BigInt::Calc](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt%3A%3ACalc/markdown).

    Provides support for big integer calculations. Not intended to be used by other modules. Other
    modules which sport the same functions can also be used to support [Math::BigInt](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt/markdown), like
    [Math::BigInt::GMP](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt%3A%3AGMP/markdown) or [Math::BigInt::Pari](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt%3A%3APari/markdown).

    In order to allow for multiple big integer libraries, [Math::BigInt](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt/markdown) was rewritten to use library
    modules for core math routines. Any module which follows the same API as this can be used
    instead by using the following:

        use [Math::BigInt](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt/markdown) lib => 'libname';

    'libname' is either the long name ('[Math::BigInt::Pari](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt%3A%3APari/markdown)'), or only the short version like 'Pari'.
    To use this library:

        use [Math::BigInt](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt/markdown) lib => 'FastCalc';

    The default behaviour is to chose the best internal representation of big integers, but the base
    length used in the internal representation can be specified explicitly. Note that this must be
    done before [Math::BigInt](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt/markdown) is loaded. For example,

        use [Math::BigInt::FastCalc](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt%3A%3AFastCalc/markdown) base_len => 3;
        use [Math::BigInt](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt/markdown) lib => 'FastCalc';

## STORAGE
    [Math::BigInt::FastCalc](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt%3A%3AFastCalc/markdown) works exactly like [Math::BigInt::Calc](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt%3A%3ACalc/markdown). Numbers are stored in decimal form
    chopped into parts.

## METHODS
    The following functions are now implemented in FastCalc.xs:

        _is_odd         _is_even        _is_one         _is_zero
        _is_two         _is_ten
        _zero           _one            _two            _ten
        _acmp           _len
        _inc            _dec
        __strip_zeros   _copy

## BUGS
    Please report any bugs or feature requests to "bug-math-bigint-fastcalc at rt.cpan.org", or
    through the web interface at <<https://rt.cpan.org/Ticket/Create.html?Queue=Math-BigInt-FastCalc>>
    (requires login). We will be notified, and then you'll automatically be notified of progress on
    your bug as I make changes.

## SUPPORT
    After installing, you can find documentation for this module with the perldoc command.

        perldoc [Math::BigInt::FastCalc](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt%3A%3AFastCalc/markdown)

    You can also look for information at:

    GitHub
        <<https://github.com/pjacklam/p5-Math-BigInt-FastCalc>>

    RT: CPAN's request tracker
        <<https://rt.cpan.org/Dist/Display.html?Name=Math-BigInt-FastCalc>>

    MetaCPAN
        <<https://metacpan.org/release/Math-BigInt-FastCalc>>

    CPAN Testers Matrix
        <<http://matrix.cpantesters.org/?dist=Math-BigInt-FastCalc>>

    CPAN Ratings
        <<https://cpanratings.perl.org/dist/Math-BigInt-FastCalc>>

## LICENSE
    This program is free software; you may redistribute it and/or modify it under the same terms as
    Perl itself.

## AUTHORS
    Original math code by Mark Biggar, rewritten by Tels <<http://bloodgate.com/>> in late 2000.

    Separated from [Math::BigInt](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt/markdown) and shaped API with the help of John Peacock.

    Fixed, sped-up and enhanced by Tels <http://bloodgate.com> 2001-2003. Further streamlining
    (api_version 1 etc.) by Tels 2004-2007.

    Maintained by Peter John Acklam <<pjacklam@gmail.com>> 2010-2021.

## SEE ALSO
    [Math::BigInt::Lib](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt%3A%3ALib/markdown) for a description of the API.

    Alternative libraries [Math::BigInt::Calc](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt%3A%3ACalc/markdown), [Math::BigInt::GMP](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt%3A%3AGMP/markdown), and [Math::BigInt::Pari](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt%3A%3APari/markdown).

    Some of the modules that use these libraries [Math::BigInt](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigInt/markdown), [Math::BigFloat](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigFloat/markdown), and [Math::BigRat](https://www.chedong.com/phpMan.php/perldoc/Math%3A%3ABigRat/markdown).