Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Number.prototype.toString(radix): rappresentare un numero in una base

Converti un valore `Number` in testo in una base da 2 a 36. Scopri come JavaScript sceglie e converte la base e perché la formattazione di un numero non equivale alla lettura del testo.

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

Sintassi

number.toString()
number.toString(radix)

Number.prototype.toString(radix) restituisce una stringa senza modificare il numero. radix è la base del sistema di numerazione: 2 per il binario e 16 per l’esadecimale. Se ometti l’argomento o passi undefined, viene usata la base 10. Il valore di this deve essere una primitiva Number o un oggetto Number; qualsiasi altro valore, come una stringa, causa un TypeError.

Secondo ECMAScript 2024, l’argomento fornito viene convertito in Number. Se il valore è finito, viene troncato verso zero: "16.9" seleziona quindi la base 16. Una base al di fuori dell’intervallo da 2 a 36 inclusi causa un RangeError. Ciò vale anche per null e NaN (ricondotti a zero) e per i valori infiniti. Un argomento di tipo Symbol o BigInt causa un TypeError durante la conversione.

Il risultato usa le cifre 0–9 seguite dalle minuscole a–z, senza aggiungere il prefisso 0b o 0x. Il - iniziale è un segno, non una rappresentazione in complemento a due; . separa la parte frazionaria. Sia +0 sia -0 producono "0"; i valori speciali producono "NaN", "Infinity" e "-Infinity". In base 10 si può usare la notazione scientifica, come in "1e+21".

Cambiare base non recupera la precisione già persa nel valore Number. L’ultima cifra significativa non è sempre determinata in modo univoco: non dare per scontato che tutti i motori restituiscano la stessa stringa. Per mantenere esatti gli interi grandi, usa BigInt fin dall’inizio e chiama BigInt.prototype.toString. parseInt(text, radix) legge la parte iniziale che rappresenta un intero, ma non convalida l’intera stringa né recupera le frazioni: parseInt("ff!", 16) restituisce 255.

Esempi

{
  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);
  }
}

Risultato

255
11111111
ff
ff
-1010.1
255
RangeError

Lo stesso numero viene stampato in decimale, binario ed esadecimale. `"16.9"` seleziona la base `16`, il numero frazionario negativo conserva il segno e la base `37` causa un `RangeError`.

Lezioni correlate

  • JavaScript · Lezione 2 · Avanzato · Versione: 4
  • JavaScript · Lezione 3 · Avanzato · Versione: 4

Fonti