Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Number.prototype.toString(radix): representar um número numa base

Converte um valor `Number` em texto numa base de 2 a 36. Vê como o JavaScript escolhe e converte a base e por que motivo formatar um número não é o mesmo que interpretar texto.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

number.toString()
number.toString(radix)

Number.prototype.toString(radix) devolve uma cadeia de caracteres sem alterar o número. radix é a base do sistema de numeração: 2 para binário e 16 para hexadecimal. Omitir o argumento ou passar undefined selecciona a base 10. O valor de this tem de ser um primitivo do tipo Number ou um objeto Number; outro valor, como uma cadeia de caracteres, provoca um TypeError.

Segundo o ECMAScript 2024, o argumento fornecido é convertido em Number. Se o valor for finito, é truncado em direção a zero: "16.9" seleciona a base 16. Uma base fora do intervalo de 2 a 36, inclusive, provoca um RangeError. Isto inclui null e NaN (reduzidos a zero), bem como os valores infinitos. Um argumento do tipo Symbol ou BigInt provoca um TypeError durante a conversão.

O resultado usa os algarismos 0–9, seguidos das minúsculas a–z, sem acrescentar o prefixo 0b ou 0x. O - inicial é um sinal, não uma representação em complemento para dois; . separa a parte fracionária. Tanto +0 como -0 dão "0"; os valores especiais dão "NaN", "Infinity" e "-Infinity". Em base 10, pode aparecer notação científica, como "1e+21".

Mudar de base não recupera a precisão já perdida no valor Number. O último algarismo significativo nem sempre é determinado de forma única, por isso não partas do princípio de que todos os motores devolvem a mesma cadeia. Para manter exatos os inteiros grandes, usa BigInt desde o início e chama BigInt.prototype.toString. parseInt(text, radix) lê a parte inicial que representa um inteiro, mas não valida toda a cadeia nem recupera frações: parseInt("ff!", 16) devolve 255.

Exemplos

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

Resultado

255
11111111
ff
ff
-1010.1
255
RangeError

O mesmo número é apresentado em decimal, binário e hexadecimal. `"16.9"` seleciona a base `16`, o número fracionário negativo mantém o sinal e a base `37` provoca um `RangeError`.

Lições relacionadas

  • JavaScript · Lição 2 · Avançado · Versão: 4
  • JavaScript · Lição 3 · Avançado · Versão: 4

Fontes