BigInt

A port from BigInteger.js to TorqueScript.

Disclaimer

This library is not fullly optimal or finished. There is a lot of things that can be done to improve its performance significantly on some aspects

Usage

There is currently two ways to use this library. The first one directly by sending in strings of integers and it will return strings.

bigint_add("343737", "125246");
bigint_subtract("343737", "125246");
bigint_multiply("343737", "125246");
bigint_divmod("343737", "125246");

The other way is through the BigInt namespace. This keeps track on the internals and will not touch string manipulation unless through initialization or explicitly telling so. It also keeps the internal state intact after each calculation.

%a = BigInt("343737");
%b = BigInt("125246");
%a.add(%b);
%a.subtract(%b);
%a.multiply(%b);
%a.divmod(%b);

%bigNum = BigInt(50) - returns a BigInt object that has access to the functions shown below %otherBigNum = BigInt("99999999999999999999999999"); - for numbers above the 32-bit limit, you have to put them in quotation marks inside of the BigInt() function, as shown here

%bigNum.add(%otherBigNum); - adds both numbers together %bigNum.subtract(%otherBigNum); - subtracts %otherBigNum from %bigNum (%bigNum - %otherBigNum) %bigNum.multiply(%otherBigNum); - multiplies both numbers together %bigNum.divMod(%otherBigNum); - divides %bigNum by %otherBigNum (%bigNum / %otherBigNum); the division is truncated, but you can retrieve the remainder with $BigInt::_Remainder, which itself is also a BigInt

%bigNum.toString(); will print the full number, no commas, nothing special.

%bigNum.equals(%otherBigNum); - returns true if both big numbers match each other (including sign), otherwise false %bigNum.greaterThanOrEqual(%otherBigNum) - returns true if %bigNum >= %otherBigNum, otherwise false %bigNum.greaterThan(%otherBigNum) - returns true if %bigNum > %otherBigNum, otherwise false %bigNum.lessThanOrEqualTo(%otherBigNum) - returns true if %bigNum <= %otherBigNum, otherwise false %bigNum.lessThan(%otherBigNum) - returns true if %bigNum < %otherBigNum, otherwise false

Performance

The performance can be read in perf.txt.

Credits

Author: McTwist (9845) Many thanks to BigInteger.js creator