CKTIS / JavaScript
DataView.prototype.getUint16(): čítanie 16-bitového celého čísla bez znamienka
Prečítajte dva bajty z pohľadu DataView ako 16-bitové celé číslo bez znamienka v poradí bajtov určenom formátom údajov.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
view.getUint16(byteOffset)
view.getUint16(byteOffset, littleEndian)DataView.prototype.getUint16 je metóda inštancie DataView. Prečíta dva po sebe idúce bajty bez zmeny vyrovnávacej pamäte a vráti hodnotu typu Number od 0 do 65535 vrátane. Pre pole so znamienkom použite getInt16().
byteOffset udáva posun v bajtoch od začiatku pohľadu, nie od začiatku vyrovnávacej pamäte ani v 16-bitových jednotkách. Zarovnanie sa nevyžaduje: nepárny posun je platný, ak sa oba bajty zmestia do pohľadu.
Voliteľný argument littleEndian sa prevedie na logickú hodnotu. true zvolí little-endian (najmenej významný bajt ako prvý); false alebo vynechanie argumentu zvolí big-endian (najvýznamnejší bajt ako prvý). Poradie bajtov vyberajte podľa formátu údajov, nie podľa architektúry procesora.
Posun sa prevedie na celočíselný index: undefined sa zmení na 0 a necelé hodnoty sa skrátia smerom k nule. Záporný výsledok prevodu vyvolá RangeError, rovnako ako čítanie, pri ktorom sa oba bajty nezmestia do platného pohľadu. TypeError nastane napríklad vtedy, keď this nie je inštanciou DataView, vyrovnávacia pamäť bola odpojená alebo samotný pohľad po jej zmenšení presahuje jej hranice.
Prí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ýsledok
4660 13330 RangeError
Pohľad sa začína na indexe `1` vo vyrovnávacej pamäti, takže posun `1` v pohľade vyberie `0x12` a `0x34`. Predvolené čítanie vráti `4660`, čítanie s `true` vráti `13330`. Pri posune `2` zostáva v pohľade už len jeden bajt, takže kód vypíše `RangeError`.
Súvisiace lekcie
- JavaScript · Lekcia 2 · Pokročilá · Verzia: 4