Math::...::Calc(3perl)

💖 NAME 💖

Math::BigInt::Calc — the pure Perl bestie that holds it down for Math::BigInt, no C compiler required, no cap 🫶

---

✨ SYNOPSIS ✨

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

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

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

# explicitly set base length and whether to "use integer"
use Math::BigInt::Calc base_len => 4, use_int => 1;
use Math::BigInt lib => 'Calc';

---

🌸 DESCRIPTION 🌸

Okay so Math::BigInt::Calc inherits from Math::BigInt::Lib. Family business 💅

In this library, the numbers are represented internally in base B = 10**N, where N is the largest possible integer that does not cause overflow in the intermediate computations. The base B elements get stored in an array, and the least significant element lives at array element zero. There are no leading zero elements — except for a single zero element when the number is zero, because even zero deserves representation, periodt. For instance, if B = 10000, the number 1234567890 is represented internally as [7890, 3456, 12]. Iconic behavior honestly 🧚

---

🎀 OPTIONS 🎀

When the module is loaded, it computes the maximum exponent, i.e., power of 10, that can be used with and without "use integer" in the computations. The default is to use this maximum exponent. And heads up bestie: if the combination of the 'base_len' value and the 'use_int' value exceeds the maximum value, an error is thrown. Not a vibe. 💀

• base_len — you can specify the base length explicitly with the 'base_len' option. The value must be a positive integer, fr fr.

use Math::BigInt::Calc base_len => 4;  # use 10000 as internal base

• use_int — this option specifies whether "use integer" should be used in the internal computations. The value is interpreted as a boolean value, so use 0 or "" for false and literally anything else for true. If the 'base_len' is not specified together with 'use_int', the current value for the base length is used. Got it? Slay.

use Math::BigInt::Calc use_int => 1;   # use "use integer" internally

---

💅 METHODS 💅

This overview contains only the methods that are specific to "Math::BigInt::Calc". For the other methods, see Math::BigInt::Lib. Yes, go read that one too, I'm not doing all the work for you 😭

• _base_len() — specify the desired base length and whether to enable "use integer" in the computations.

Math::BigInt::Calc -> _base_len($base_len, $use_int);

Note that it is better to specify the base length and whether to use integers as options when the module is loaded, for example like this:

use Math::BigInt::Calc base_len => 6, use_int => 1;

---

👑 SEE ALSO 👑

• Math::BigInt::Lib for a description of the API.
• Alternative libraries: Math::BigInt::FastCalc, Math::BigInt::GMP, Math::BigInt::Pari, Math::BigInt::GMPz, and Math::BigInt::BitVect. Options, options, options 💖
• Some of the modules that use these libraries: Math::BigInt, Math::BigFloat, and Math::BigRat.

---

that's the whole page, bestie — go forth and compute big numbers the pure Perl way ✨ This was perl v5.44.0, dated 2026-10-17, from the Perl Programmers Reference Guide. mwah 💋🌸