JS BigInt.asUintN()
The BigInt.asUintN
static method is used to wrap a BigInt value to an unsigned integer between between 0 and 2width-1.
The source for this interactive example is stored in a GitHub repository. If you’d like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Syntax
BigInt.asUintN(width, bigint);
Parameters
width
The amount of bits available for the integer size.
bigint
The integer to clamp to fit into the supplied bits.
Returns
The value of bigint
modulo 2width
as an unsigned integer.
Examples
Staying in 64-bit ranges
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
Specifications
Specification | Status |
---|---|
BigInt proposal | Stage 3 |