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