BigInt.asUintN()

BigInt.asUintN 静的メソッドは、 BigInt 値を符号なし整数に丸め、その値を返します。

試してみましょう

構文

js

BigInt.asUintN(bits, bigint);

引数

bits

整数の大きさのために利用できるビット数。

bigint

指定されたビット数に収めるよう丸める整数値。

返値

bigint を 2^bits で割った剰余の値の符号なし整数です。

例

64ビットの範囲に収める

BigInt.asUintN() メソッドは、64ビットの数値の範囲に収めるのに便利です。

js

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

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

BigInt.asUintN(64, max + 1n);
// ↪ 0n
// オーバーフローするのでゼロになる

仕様書

Specification
ECMAScript Language Specification
# sec-bigint.asuintn

ブラウザーの互換性

BCD tables only load in the browser

関連情報