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