BigInt.asUintN()

Probieren Sie es aus

const U64_CEIL = 2n ** 64n;

console.log(BigInt.asUintN(64, U64_CEIL - 1n));
// 18446744073709551615n (2n ** 64n - 1n, the maximum non-wrapping value)
console.log(BigInt.asUintN(64, U64_CEIL));
// 0n (wraps to zero)
console.log(BigInt.asUintN(64, U64_CEIL + 1n));
// 1n
console.log(BigInt.asUintN(64, U64_CEIL * 2n));
// 0n (wraps on multiples)
console.log(BigInt.asUintN(64, U64_CEIL * -42n));
// 0n (also wraps on negative multiples)

Syntax

BigInt.asUintN(bits, bigint)

Parameter

bits

Die Anzahl der Bits, die für das zurückgegebene BigInt verfügbar sind. Es sollte eine Ganzzahl zwischen 0 und 2⁵³ - 1 sein, einschließlich.

bigint

Der BigInt-Wert, der abgeschnitten werden soll, um in die angegebenen Bits zu passen.

Rückgabewert

Der Wert von bigint modulo 2 ** bits, als vorzeichenlose Ganzzahl.

Ausnahmen

RangeError

Wird ausgelöst, wenn bits negativ oder größer als 2⁵³ - 1 ist.

Beschreibung

Die Methode BigInt.asUintN schneidet einen BigInt-Wert auf die angegebene Anzahl von Bits ab und interpretiert das Ergebnis als vorzeichenlose Ganzzahl. Vorzeichenlose Ganzzahlen haben keine Vorzeichenbits und sind immer nicht-negativ. Zum Beispiel wird bei BigInt.asUintN(4, 25n) der Wert 25n auf 9n gekürzt:

25n = 00011001 (base 2)
         ^==== Use only the four remaining bits
===>      1001 (base 2) = 9n

Im Gegensatz zu ähnlichen API-Funktionen in anderen Sprachen wie Number.prototype.toExponential() ist asUintN eine statische Eigenschaft von BigInt, sodass Sie sie immer als BigInt.asUintN() und nicht als Methode eines BigInt-Werts verwenden. Das Bereitstellen von asUintN() als "Standard-Bibliotheksfunktion" ermöglicht die Interoperabilität mit asm.js.

Beispiele

Im Bereich von 64-Bit bleiben

Die Methode BigInt.asUintN() kann nützlich sein, um im Bereich der 64-Bit-Arithmetik zu bleiben.

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

• BigInt
• BigInt.asIntN()