Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

DataView.prototype.getUint16(): leggere un intero senza segno a 16 bit

Leggi due byte di una DataView come intero senza segno a 16 bit, usando l’ordine dei byte specificato dal formato dei dati.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

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

DataView.prototype.getUint16 è un metodo di istanza di DataView. Legge due byte consecutivi senza modificare il buffer e restituisce un valore Number da 0 a 65535, estremi inclusi. Se il campo è con segno, usa getInt16().

byteOffset conta i byte a partire dall’inizio della vista, non dall’inizio del buffer né in unità da 16 bit. Non ci sono vincoli di allineamento: un offset dispari è valido se entrambi i byte rientrano nella vista.

L’argomento facoltativo littleEndian viene convertito in un valore booleano. true seleziona little-endian (prima il byte meno significativo); false o l’omissione dell’argomento seleziona big-endian (prima il byte più significativo). Scegli l’ordine dei byte in base al formato dei dati, non all’architettura del processore.

L’offset viene convertito in un indice intero: undefined diventa 0 e i valori frazionari vengono troncati verso zero. Un risultato negativo causa un RangeError, così come una lettura per cui i due byte non rientrano in una vista valida. Si verifica un TypeError, per esempio, se this non è un’istanza di DataView, se il buffer è scollegato o se la vista stessa supera i limiti del buffer dopo che questo è stato ridotto.

Esempi

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);
}

Risultato

4660
13330
RangeError

La vista inizia all’indice `1` del buffer, perciò l’offset `1` nella vista seleziona `0x12` e `0x34`. La lettura predefinita restituisce `4660`, mentre quella con `true` restituisce `13330`. All’offset `2` rimane un solo byte nella vista, quindi il codice stampa `RangeError`.

Lezioni correlate

  • JavaScript · Lezione 2 · Avanzato · Versione: 4

Fonti