BigInt.asUintN()

bits

The amount of bits available for the integer size.

bigint

The BigInt value to clamp to fit into the supplied bits.

The value of bigint modulo 2^bits, as an unsigned integer.

The BigInt.asUintN method clamps a BigInt value to the given number of bits, and interprets the result as an unsigned integer. Unsigned integers have no sign bits and are always non-negative. For example, for BigInt.asUintN(4, 25n), the value 25n is clamped to 9n:

25n = 00011001 (base 2)
         ^==== Clamp to four remaining bits
===>      1001 (base 2) = 9n

The BigInt.asUintN() method can be useful to stay in the range of 64-bit arithmetic.

const max = 2n ** 64n - 1n;

BigInt.asUintN(64, max);
// ↪ 18446744073709551615n

BigInt.asUintN(64, max + 1n);
// ↪ 0n
// zero because of overflow: the lowest 64 bits are all zeros

• BigInt
• BigInt.asIntN()