Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

DataView.prototype.getUint16(): leer un entero de 16 bits sin signo

Lee dos bytes de una DataView como un entero de 16 bits sin signo, usando el orden de bytes que especifique el formato de los datos.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

view.getUint16(byteOffset)
view.getUint16(byteOffset, littleEndian)

DataView.prototype.getUint16 es un método de instancia de DataView. Lee dos bytes consecutivos sin modificar el búfer y devuelve un Number de 0 a 65535, ambos inclusive. Si el campo tiene signo, usa getInt16().

byteOffset cuenta bytes desde el comienzo de la vista, no desde el comienzo del búfer ni en unidades de 16 bits. No hay restricciones de alineación: un desplazamiento impar es válido si ambos bytes caben en la vista.

El argumento opcional littleEndian se convierte en un booleano. true selecciona little-endian (primero el byte menos significativo); false u omitir el argumento selecciona big-endian (primero el byte más significativo). Elige el orden de bytes según el formato de los datos, no según la arquitectura del procesador.

El desplazamiento se convierte en un índice entero: undefined se convierte en 0 y los valores fraccionarios se truncan hacia cero. Un resultado negativo provoca un RangeError, al igual que intentar leer dos bytes que no caben en una vista válida. Se produce un TypeError, por ejemplo, si this no es una instancia de DataView, si el búfer está desvinculado o si la propia vista queda fuera de los límites del búfer al reducirse su tamaño.

Ejemplos

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

La vista empieza en el índice `1` del búfer, así que el desplazamiento `1` dentro de la vista selecciona `0x12` y `0x34`. La lectura predeterminada devuelve `4660` y la lectura con `true` devuelve `13330`. En el desplazamiento `2` solo queda un byte en la vista, por lo que el código muestra `RangeError`.

Lecciones relacionadas

  • JavaScript · Lección 2 · Avanzado · Versión: 4

Fuentes