Basic Methods

Low-level arithmetic functions for maximum performance.

Binary Operations (Multi-argument)

Method	Description	Example
add	Addition	add(0.1, 0.2) → 0.3
sub	Subtraction	sub(0.3, 0.1) → 0.2
mul	Multiplication	mul(0.1, 0.2) → 0.02
div	Division	div(0.3, 0.1) → 3
mod	Modulo	mod(10, 3) → 1
pow	Power	pow(2, 10) → 1024
idiv	Integer division	idiv(10, 3) → 3

Unary Operations

Method	Description	Example
abs	Absolute value	abs(-5) → 5
neg	Negate	neg(5) → -5
sqrt	Square root	sqrt(16) → 4
ln	Natural log	ln(2.718) → 0.999...
exp	e^x	exp(1) → 2.718...

Return Type

Default return type is number. Pass 'string' as the last argument to get a string:

import { add, mul, div } from "a-calc";

add(1, 2); // 3 (number)
add(1, 2, "string"); // '3' (string)
mul(2, 3, "string"); // '6' (string)

Multi-argument Support

add(1, 2, 3, 4, 5); // 15
sub(100, 20, 30); // 50
mul(2, 3, 4); // 24
div(1000, 10, 5); // 20

r-prefix Variants (String I/O)

The r* prefix functions always take and return strings, and follow _compute_mode:

import { radd, rmul, rdiv } from "a-calc";

radd("0.1", "0.2"); // "0.3"
rmul("0.1", "0.2"); // "0.02"
rdiv("1", "3"); // "0.33333333333333333333"

vs calc

Feature	Basic methods	calc
Performance	faster	baseline
Formatting	❌	✅
Variables	❌	✅
Complex expressions	❌	✅
Multi-argument	✅	—

Real-World Usage

import { mul, add } from "a-calc";

const price = 99.9;
const quantity = 3;
const shipping = 10;

const subtotal = mul(price, quantity); // 299.7
const total = add(subtotal, shipping); // 309.7