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