The BigInt type, representing arbitrary precision integers

of_int n creates a BigInt from an OCaml integer

of_int64 n creates a BigInt from an OCaml int64

of_string s creates a BigInt from a string representation. Supports decimal, hexadecimal (0x prefix), binary (0b prefix), and octal (0o prefix) formats. Whitespace is trimmed. Empty string returns 0. Invalid strings return 0.

of_string_exn s creates a BigInt from a string representation. Like of_string but raises Failure on invalid input.

to_string ?radix bigint returns a string representation. radix can be 2-36 (default 10).

Alias for to_string with default radix 10

to_float bigint converts to float. May lose precision for large values.

neg x returns the negation of x

abs x returns the absolute value of x

add x y returns x + y

sub x y returns x - y

mul x y returns x * y

div x y returns x / y, truncated toward zero. Raises Division_by_zero if y is zero.

rem x y returns the remainder of x / y. The sign follows the dividend (JavaScript semantics). Raises Division_by_zero if y is zero.

pow base exp returns base raised to the power exp. Raises Invalid_argument if exp is negative.

logand x y returns the bitwise AND of x and y

logor x y returns the bitwise OR of x and y

logxor x y returns the bitwise XOR of x and y

lognot x returns the bitwise NOT of x (two's complement)

shift_left x n returns x shifted left by n bits

shift_right x n returns x arithmetically shifted right by n bits. Sign-extending for negative numbers.

compare x y returns -1 if x < y, 0 if x = y, 1 if x > y

equal x y returns true if x = y

lt x y returns true if x < y

le x y returns true if x <= y

gt x y returns true if x > y

ge x y returns true if x >= y

as_int_n bits x wraps x to a signed integer of bits bits. Equivalent to JavaScript's BigInt.asIntN.

as_uint_n bits x wraps x to an unsigned integer of bits bits. Equivalent to JavaScript's BigInt.asUintN.