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