Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

DataView.prototype.getUint16(): čtení 16bitového celého čísla bez znaménka

Přečtěte dva bajty z pohledu DataView jako 16bitové celé číslo bez znaménka v pořadí bajtů předepsaném formátem dat.

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

Syntaxe

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

DataView.prototype.getUint16 je metoda instance DataView. Přečte dva po sobě jdoucí bajty, aniž by změnila vyrovnávací paměť, a vrátí hodnotu typu Number od 0 do 65535 včetně. Pro pole se znaménkem použijte getInt16().

byteOffset udává posun v bajtech od začátku pohledu, nikoli od začátku vyrovnávací paměti ani v 16bitových jednotkách. Zarovnání není nutné: lichý posun je platný, pokud se oba bajty vejdou do pohledu.

Nepovinný argument littleEndian se převede na logickou hodnotu. true zvolí little-endian (nejméně významný bajt první); false nebo vynechání argumentu zvolí big-endian (nejvýznamnější bajt první). Pořadí bajtů volte podle formátu dat, ne podle architektury procesoru.

Posun se převede na celočíselný index: undefined se změní na 0 a necelé hodnoty se oříznou směrem k nule. Záporný výsledek převodu vyvolá RangeError, stejně jako čtení, při kterém se oba bajty nevejdou do platného pohledu. TypeError nastane například tehdy, když this není instancí DataView, vyrovnávací paměť byla odpojena nebo samotný pohled po jejím zmenšení přesahuje její hranice.

Příklady

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

Výsledek

4660
13330
RangeError

Pohled začíná na indexu `1` ve vyrovnávací paměti, takže posun `1` v pohledu vybere `0x12` a `0x34`. Výchozí čtení vrátí `4660`, čtení s argumentem `true` vrátí `13330`. Na posunu `2` zbývá v pohledu jen jeden bajt, proto kód vypíše `RangeError`.

Související lekce

  • JavaScript · Lekce 2 · Pokročilá · Verze: 4

Zdroje