BigInt.prototype.toString()

The toString() method returns a string representing the specified BigInt object. The trailing "n" is not part of the string.

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

Sp√©cification √Čtat
Proposition pour BigInt Proposition de niveau 3

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi