O método toString()
retorna uma string com o valor do objecto Number
especificado.
Sintaxe
numObj.toString([radix])
Parâmetros
base
- Opcional. Um inteiro entre [2, 36] especificando a base usada para representar o valor númerico.
Erros possíveis
RangeError
- Se o valor do parâmetro base não estiver entre [2, 36], o erro
RangeError
é lançado.
Descrição
O objecto Number
faz override ao método toString()
do objecto Object
; não herda de Object.prototype.toString()
. Para os objectos Number
, o método toString()
retorna uma representação em string do ojecto na base especificada.
O método toString()
analisa o seu primeiro argumento e tenta retornar uma representação em string na base especificada. Para bases superiores a 10, as letras do alfabeto representam numerais maiores do que 9 (por ordem alfabética: a, b, c ...). Por exemplo, para números hexadecimais (base 16) são usadasa as letras do alfabeto até f
.
Se a base
não for especificada, o seu valor assumido é 10.
Se o numObj
tem um valor negativo (< 0), o sinal é preservado. O mesmo se aplica se a base tiver o valor 2; a string retornada é a representação positiva do binário de numObj
precedida pelo sinal negativo (-), e não complement para 2 de numObj
.
Exemplos
Usando toString
var count = 10; console.log(count.toString()); // imprime '10' console.log((17).toString()); // imprime '17' var x = 6; console.log(x.toString(2)); // imprime '110' console.log((254).toString(16)); // imprime 'fe' console.log((-10).toString(2)); // imprime '-1010' console.log((-0xff).toString(2)); // imprime'-11111111'
Especificações
Specification | Status | Comment |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | Definição inicial. Implementado em JavaScript 1.1. |
ECMAScript 5.1 (ECMA-262) The definition of 'Number.prototype.tostring' in that specification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Number.prototype.tostring' in that specification. |
Standard |
Compatibilidade dos browsers
Funcionalidade | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Suporte básico | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Funcionalidade | Android | Chrome para Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
BSuporte básico | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |