MikeMcl/bignumber.js
Bignumber.js
bignumber.js is an arbitrary-precision JavaScript library designed to perform mathematical operations on decimals and integers that exceed the limits of standard floating-point numbers. It functions as a decimal arithmetic engine and a math library for calculating square roots, powers, and modular exponentiation.
The project provides a base conversion utility capable of parsing and translating numeric values between any base from 2 to 36. It also includes a numeric formatting tool for rendering high-precision values into localized strings with custom separators and notation styles.
The library covers a broad range of capabilities, including arbitrary precision arithmetic, configurable rounding rules, and high-precision value comparisons. It also provides tools for decimal to fraction conversion and cryptographically secure random number generation.
Features
- Arbitrary Precision Arithmetic - Executes addition, subtraction, multiplication, and division on numbers exceeding standard floating-point limits.
- Decimal Rounding Utilities - Adjusts numbers to a specific count of decimal places or significant digits using modes like floor or half-even.
- Base Conversion Utilities - Includes functions for transforming numbers between different numerical bases from 2 to 36.
- Digit-Array Arithmetic - Performs mathematical operations by manipulating individual digits in an array to simulate manual long-form calculation.
- Financial Numeric Precision - Handles money and currency values with strict rounding rules and fixed decimal precision to avoid floating-point errors.
- Exact Value Comparisons - Determines if one number is equal to, greater than, or less than another using exact high-precision comparison.
- Precision-Tolerant Comparisons - Determines equality or magnitude by comparing digit sequences and exponents instead of using native numeric operators.
- High-Precision Number Initialization - Initializes high-precision numbers from strings, native numbers, or other bases using exponential notation and separators.
- JavaScript Math Libraries - Provides a comprehensive set of functions for square roots, powers, and modular exponentiation using arbitrary precision.
- Numerical Base Conversions - Implements a comprehensive system for parsing and translating numeric values between any base from 2 to 36.
- Rounding Modes - Applies specific mathematical modes like floor or half-even to truncate high-precision results to a defined scale.
- Precision Arithmetic - Executes high-precision addition, subtraction, multiplication, and division with configurable rounding modes.
- String-Based Numeric Storage - Stores numbers as strings of digits to bypass the precision limits and overflow of native floating-point types.
- Numeric String Extractors - Extracts numeric values from strings containing non-numeric characters such as currency symbols or group separators.
- Arbitrary Base Conversion - Translates numbers between different bases from 2 to 36, including binary, octal, and hexadecimal representations.
- Base-Agnostic Numeric Parsing - Processes numeric values in any base from 2 to 36 using a customizable alphabet.
- Calculation Precision Configurations - Defines global or instance rules for decimal precision, rounding modes, and exponential notation thresholds.
- Exponential Operations - Provides calculations for square roots, powers with modular exponentiation, and modulo remainders.
- Localized Numeric Formatting - Converts large or precise numbers into localized strings with custom separators and notation styles.
- Numeric Data Formatting - Converts raw high-precision numeric values into human-readable strings using localized separators and notation styles.
- Rational Approximations - Implements algorithms to find the best rational approximation of a decimal value given a denominator limit.
- Cryptographic Random Number Generators - Produces high-entropy pseudo-random values for security-sensitive applications using cryptographically-secure methods.
- Numeric Formatting - Provides logic for applying visual separators, localized fixed-point notation, and internationalization patterns to high-precision numbers.
- Numeric and Math Utilities - Arbitrary-precision decimal and non-decimal arithmetic.
