BigInt : méthode statique asIntN()

Exemple interactif

const I64_CEIL = 2n ** 63n;

console.log(BigInt.asIntN(64, I64_CEIL - 1n));
// 9223372036854775807n (2n ** 64n - 1n, le maximum sans dépassement)
console.log(BigInt.asIntN(64, I64_CEIL));
// -9223372036854775808n (dépassement vers la valeur minimale)
console.log(BigInt.asIntN(64, I64_CEIL + 1n));
// -9223372036854775807n (valeur minimale + 1n)
console.log(BigInt.asIntN(64, I64_CEIL * 2n));
// 0n (retour à zéro)
console.log(BigInt.asIntN(64, -I64_CEIL * -42n));
// 0n (retour à zéro sur les multiples négatifs)

Syntaxe

BigInt.asIntN(bits, bigint)

Paramètres

bits

Le nombre de bits disponibles pour le BigInt retourné. Doit être un entier compris entre 0 et 2⁵³ - 1 inclus.

bigint

La valeur BigInt à tronquer pour tenir dans le nombre de bits fourni.

Valeur de retour

La valeur de bigint modulo 2 ** bits comme entier signé.

Exceptions

RangeError

Levée si bits est négatif ou supérieur à 2⁵³ - 1.

Description

La méthode BigInt.asIntN tronque une valeur BigInt au nombre de bits donné et interprète le résultat comme un entier signé. Par exemple, pour BigInt.asIntN(3, 25n), la valeur 25n est tronquée à 1n :

25n = 00011001 (base 2)
          ^=== On ne garde que les trois bits restants
===>       001 (base 2) = 1n

Si le bit de poids fort du nombre restant est 1, le résultat est négatif. Par exemple, BigInt.asIntN(4, 25n) donne -7n, car 1001 est le codage de -7 en complément à deux :

25n = 00011001 (base 2)
         ^==== On ne garde que les quatre bits restants
===>      1001 (base 2) = -7n

Contrairement aux API de langages similaires comme Number.prototype.toExponential(), asIntN est une propriété statique de BigInt, donc vous l'utilisez toujours comme BigInt.asIntN(), plutôt que comme une méthode d'une valeur BigInt. Exposer asIntN() comme « fonction de la bibliothèque standard » permet l'interopérabilité avec asm.js ^(angl.).

Exemples

Rester dans les plages 64 bits

La méthode BigInt.asIntN() peut être utile pour rester dans une arithmétique sur 64 bits :

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

BigInt.asIntN(64, max); // 9223372036854775807n

BigInt.asIntN(64, max + 1n); // -9223372036854775807n
// négatif car dépassement sur le nombre de bits

Spécifications

Compatibilité des navigateurs

Voir aussi

• La valeur BigInt
• La méthode statique BigInt.asUintN()