Math::...stCalc(3perl)

💖 NAME 💖

This is the Math::BigInt::FastCalc(3perl) page, bestie, and here's the whole vibe in one line:

Math::BigInt::FastCalc — Math::BigInt::Calc with some XS for more speed ✨

---

🌈 SYNOPSIS 🌈

# to use it with Math::BigInt
use Math::BigInt lib => 'FastCalc';

# to use it with Math::BigFloat
use Math::BigFloat lib => 'FastCalc';

# to use it with Math::BigRat
use Math::BigRat lib => 'FastCalc';

---

🦋 DESCRIPTION 🦋

okay so, first thing: Math::BigInt::FastCalc inherits from Math::BigInt::Calc. periodt. 💅

It provides support for big integer calculations. But — and this is the important part — it is not intended to be used by other modules. 🙈 Other modules which sport the same functions can also be used to support Math::BigInt, like Math::BigInt::GMP or Math::BigInt::Pari.

Here's the lore: in order to allow for multiple big integer libraries, Math::BigInt was rewritten to use library modules for core math routines. Any module which follows the same API as this one can be used instead, like this:

use Math::BigInt lib => 'libname';

'libname' is either the long name ('Math::BigInt::Pari'), or only the short version like 'Pari'. To use this library:

use Math::BigInt lib => 'FastCalc';

The default behaviour is to choose the best internal representation of big integers, but the base length used in the internal representation can be specified explicitly. Big heads up though, bestie: this must be done before Math::BigInt is loaded. For example,

use Math::BigInt::FastCalc base_len => 3;
use Math::BigInt lib => 'FastCalc';

---

🎀 STORAGE 🎀

Math::BigInt::FastCalc works exactly like Math::BigInt::Calc. Numbers are stored in decimal form chopped into parts. 🔪🍰 it's giving… tiny decimal pieces, no cap.

---

👑 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

the way that list just sits there looking all fast and XS-y… ate. 🔥

---

💀 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, sorry 🫶). We will be notified, and then you'll automatically be notified of progress on your bug as changes get made. 💌 literally a whole notification pipeline, iconic.

---

🫶 SUPPORT 🫶

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

perldoc Math::BigInt::FastCalc

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>

---

📜 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 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.

so many hands on this codebase, it's giving collab album energy. 🌟

---

🌈 SEE ALSO 🌈

• Math::BigInt::Lib for a description of the API.
• Alternative libraries Math::BigInt::Calc, Math::BigInt::GMP, and Math::BigInt::Pari.
• Some of the modules that use these libraries: Math::BigInt, Math::BigFloat, and Math::BigRat.

---

k that's the whole page, bestie, and that's on perl v5.44.0 from 2026-10-17 💖 go forth and calculate your big integers fastly, slay, mwah 🎀🦋✨