Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Number.prototype.toString(radix) : écrire un nombre dans une base donnée

Convertissez une valeur `Number` en texte dans une base de 2 à 36. Découvrez comment JavaScript choisit et convertit la base, et en quoi le formatage diffère de l’analyse du texte.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

number.toString()
number.toString(radix)

Number.prototype.toString(radix) renvoie une chaîne sans modifier le nombre. radix est la base de numération : 2 pour le binaire, 16 pour l’hexadécimal. Omettre l’argument ou passer undefined sélectionne la base 10. La valeur de this doit être une primitive Number ou un objet Number ; toute autre valeur, comme une chaîne, provoque une TypeError.

Selon ECMAScript 2024, l’argument fourni est converti en Number. Si le résultat est fini, sa partie fractionnaire est tronquée vers zéro : "16.9" sélectionne donc la base 16. Une base en dehors de l’intervalle de 2 à 36 inclus provoque une RangeError. C’est aussi le cas de null et NaN (ramenés à zéro) et des valeurs infinies. Un argument de type Symbol ou BigInt provoque une TypeError lors de la conversion.

Le résultat utilise les chiffres 0–9, puis les minuscules a–z, sans ajouter de préfixe 0b ou 0x. Le - initial est un signe, pas un encodage en complément à deux ; le point . sépare la partie fractionnaire. +0 et -0 donnent tous deux "0" ; les valeurs spéciales donnent "NaN", "Infinity" et "-Infinity". La base 10 peut employer la notation scientifique, par exemple "1e+21".

Un changement de base ne restitue pas la précision déjà perdue dans la valeur Number. Le dernier chiffre significatif n’est pas toujours déterminé de façon unique ; ne supposez donc pas que tous les moteurs renvoient la même chaîne. Pour conserver exactement de grands entiers, utilisez BigInt dès le départ et appelez BigInt.prototype.toString. parseInt(text, radix) lit la partie initiale qui représente un entier, sans valider toute la chaîne ni restituer les fractions : parseInt("ff!", 16) renvoie 255.

Exemples

{
  const n = 255;
  console.log(n.toString());
  console.log(n.toString(2));
  console.log(n.toString(16));
  console.log(n.toString("16.9"));
  console.log((-10.5).toString(2));
  console.log(parseInt(n.toString(16), 16));

  try {
    n.toString(37);
  } catch (error) {
    console.log(error.name);
  }
}

Résultat

255
11111111
ff
ff
-1010.1
255
RangeError

Le même nombre s’affiche en décimal, en binaire et en hexadécimal. `"16.9"` sélectionne la base `16`, le nombre fractionnaire négatif conserve son signe et la base `37` provoque une `RangeError`.

Leçons associées

  • JavaScript · Leçon 2 · Avancé · Version : 4
  • JavaScript · Leçon 3 · Avancé · Version : 4

Sources