BigInt.prototype.toString()

Exemple interactif

console.log(1024n.toString());
// Expected output: "1024"

console.log(1024n.toString(2));
// Expected output: "10000000000"

console.log(1024n.toString(16));
// Expected output: "400"

Syntaxe

bigIntObj.toString([base]);

Paramètres

baseFacultatif

Ce paramètre optionnel est compris entre 2 et 36 et indique la base à utiliser pour représenter les valeurs numériques.

Valeur de retour

Une chaîne de caractères représentant l'objet BigInt courant.

Exceptions

RangeError

Si la base fournie comme argument toString() est inférieure à 2 ou supérieure à 36, cela déclenchera une exception RangeError.

Description

L'objet BigInt surcharge la méthode toString() de Object. Il n'hérite pas ou n'utilise pas Object.prototype.toString(). Pour les objets BigInt, la méthode toString() renvoie une représentation textuelle de l'objet dans la base indiquée.

La méthode toString() analyse le premier argument qui lui est passé et tente de renvoyer une représentation textuelle dans cette base. Pour les bases supérieures à 10, ce seront les lettres de l'alphabet pour indiquer les chiffres supérieurs à 9. Pour les nombres hexadécimaux (base 16), les lettres a à f sont utilisées par exemple.

Si l'argument base n'est pas indiquée, ce sera la base 10 qui sera considérée par défaut.

Si bigIntObj est négatif, le signe est conservé, y compris lorsque la base est 2 (dans ce cas, la chaîne renvoyée sera la représentation binaire précédée par un signe - et non le complément à deux de bigIntObj).

Exemples

Utiliser toString()

17n.toString(); // '17'
66n.toString(2); // '1000010'
254n.toString(16); // 'fe'
-10n.toString(2); // -1010'
-0xffn.toString(2); // '-11111111'

Gestion du zéro négatif en BigInt

Il n'existe pas de zéro négatif pour BigInt car les entiers ne gèrent pas de concept de zéro négatif. -0.0 est un concept relatif à la représentation flottante IEEE et n'est présent que pour le type Number.

(-0n).toString(); // '0'
BigInt(-0).toString(); // '0'

Spécifications

Compatibilité des navigateurs

Voir aussi

• BigInt.prototype.toLocaleString()
• BigInt.prototype.valueOf()
• Number.prototype.toString()