CKTIS / JavaScript
DataView.prototype.getUint16(): odczyt 16-bitowej liczby bez znaku
Odczytaj dwa bajty z widoku DataView jako 16-bitową liczbę całkowitą bez znaku, dobierając kolejność bajtów do formatu danych.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
view.getUint16(byteOffset)
view.getUint16(byteOffset, littleEndian)DataView.prototype.getUint16 to metoda instancji DataView. Odczytuje dwa kolejne bajty bez modyfikowania bufora i zwraca wartość typu Number od 0 do 65535 włącznie. Jeśli pole ma znak, użyj getInt16().
byteOffset oznacza przesunięcie w bajtach od początku widoku, a nie od początku bufora ani w jednostkach 16-bitowych. Wyrównanie nie jest wymagane: nieparzyste przesunięcie jest poprawne, jeśli oba bajty mieszczą się w widoku.
Opcjonalny argument littleEndian jest konwertowany na wartość logiczną. true wybiera little-endian (najmniej znaczący bajt pierwszy); false lub pominięcie argumentu wybiera big-endian (najbardziej znaczący bajt pierwszy). Wybieraj kolejność zgodną z formatem danych, a nie z architekturą procesora.
Przesunięcie jest konwertowane na indeks całkowity: undefined daje 0, a część ułamkowa jest odrzucana w kierunku zera. Ujemny wynik tej konwersji wywołuje RangeError; ten sam błąd występuje, gdy w prawidłowym widoku nie mieszczą się oba bajty. TypeError występuje m.in. wtedy, gdy this nie jest instancją DataView, bufor został odłączony albo po zmniejszeniu bufora sam widok wykracza poza jego granice.
Przykłady
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);
}Wynik
4660 13330 RangeError
Widok zaczyna się od indeksu `1` bufora, więc przesunięcie `1` w widoku wskazuje na bajty `0x12` i `0x34`. Domyślny odczyt daje `4660`, a odczyt z `true` daje `13330`. Przy przesunięciu `2` w widoku pozostał tylko jeden bajt, więc kod wypisuje `RangeError`.
Powiązane lekcje
- JavaScript · Lekcja 2 · Zaawansowany · Wersja: 4