CKTIS / JavaScript
Literais numéricos hexadecimais
Escreve números inteiros na base 16 com `0x` ou `0X` e acrescenta `n` quando precisares de um valor `BigInt` exato.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
Simplified grammar (brackets mark optional parts):
HexLiteral ::= ("0x" | "0X") HexDigit (["_"] HexDigit)* ["n"]
HexDigit ::= "0"–"9" | "a"–"f" | "A"–"F"Os literais numéricos hexadecimais permitem escrever números inteiros na base 16 diretamente no código-fonte. A seguir a 0x ou 0X tem de haver pelo menos um algarismo de 0–9, a–f ou A–F. Usar maiúsculas ou minúsculas não altera o valor: 0xFF === 255 dá true.
Só podes colocar um único _ entre dois algarismos. 0xF_F é válido, mas 0x_FF, 0xF__F e 0xFF_ provocam um SyntaxError durante a análise sintática. Estes literais não têm parte fracionária nem expoente; o e em 0x1e2 é um algarismo. Em -0xFF, - é um operador unário separado.
Sem sufixo, o literal produz um Number. Quando o valor absoluto excede Number.MAX_SAFE_INTEGER, fica fora do intervalo dos inteiros seguros e nem todos os inteiros podem ser representados com exatidão. Acrescenta um n minúsculo logo após o último algarismo para obteres um BigInt exato. Em ambientes de execução mais antigos, verifica se há suporte para BigInt e separadores numéricos.
"0xFF" é uma cadeia de caracteres, não um literal numérico. Number("0xFF") devolve 255, mas Number("0xF_F") devolve NaN: a conversão de cadeias não aceita separadores numéricos. Para formatar um valor como texto hexadecimal, usa (255).toString(16), que devolve "ff" sem prefixo.
Exemplos
{
const byte = 0Xf_f;
const rounded = 0x20_0000_0000_0001;
const exact = 0x20_0000_0000_0001n;
console.log(`${byte} ${byte === 255} ${byte.toString(16)}`);
console.log(`${rounded}`);
console.log(`${exact} ${typeof exact}`);
}Resultado
255 true ff 9007199254740992 9007199254740993 bigint
A primeira linha mostra o valor decimal, o resultado da comparação e o texto hexadecimal. As duas seguintes mostram que `Number` arredonda este inteiro grande, enquanto `BigInt` o mantém exato.
Lições relacionadas
- JavaScript · Lição 2 · Avançado · Versão: 4
Fontes
- ECMAScript 2024 Language Specification — Numeric Literals
- ECMAScript 2024 Language Specification — Unary − Operator
- ECMAScript 2024 Language Specification — Number.MAX_SAFE_INTEGER
- ECMAScript 2024 Language Specification — ToNumber Applied to the String Type
- Lexical grammar — Hexadecimal
- Number.prototype.toString()