CKTIS / JavaScript
DataView.prototype.getUint16(): ler um inteiro de 16 bits sem sinal
Lê dois bytes de uma DataView como um inteiro de 16 bits sem sinal, usando a ordem dos bytes definida pelo formato dos dados.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
view.getUint16(byteOffset)
view.getUint16(byteOffset, littleEndian)DataView.prototype.getUint16 é um método de instância de DataView. Lê dois bytes consecutivos sem modificar o buffer e devolve um Number de 0 a 65535, inclusive. Se o campo tiver sinal, usa getInt16().
byteOffset conta bytes a partir do início da vista, não do início do buffer nem em unidades de 16 bits. Não há requisitos de alinhamento: um deslocamento ímpar é válido se ambos os bytes couberem na vista.
O argumento opcional littleEndian é convertido num valor booleano. true seleciona little-endian (o byte menos significativo primeiro); false ou a omissão do argumento seleciona big-endian (o byte mais significativo primeiro). Escolhe a ordem dos bytes consoante o formato dos dados, não a arquitetura do processador.
O deslocamento é convertido num índice inteiro: undefined passa a 0 e os valores fracionários são truncados em direção a zero. Um resultado negativo provoca um RangeError, tal como uma leitura em que os dois bytes não cabem numa vista válida. Ocorre um TypeError, por exemplo, se this não for uma instância de DataView, se o buffer estiver desligado ou se a própria vista ficar fora dos limites do buffer depois de este ser reduzido.
Exemplos
const bytes = new Uint8Array([0xaa, 0xbb, 0x12, 0x34, 0xcc]);
const view = new DataView(bytes.buffer, 1, 3);
console.log(view.getUint16(1));
console.log(view.getUint16(1, true));
try {
view.getUint16(2);
} catch (error) {
console.log(error.name);
}Resultado
4660 13330 RangeError
A vista começa no índice `1` do buffer, pelo que o deslocamento `1` na vista seleciona `0x12` e `0x34`. A leitura por omissão devolve `4660` e a leitura com `true` devolve `13330`. No deslocamento `2` resta apenas um byte na vista, pelo que o código apresenta `RangeError`.
Lições relacionadas
- JavaScript · Lição 2 · Avançado · Versão: 4