CKTIS / JavaScript
DataView.prototype.getUint16(): branje 16-bitnega nepredznačenega celega števila
Preberi dva bajta iz pogleda DataView kot 16-bitno nepredznačeno celo število v vrstnem redu bajtov, ki ga določa format podatkov.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
view.getUint16(byteOffset)
view.getUint16(byteOffset, littleEndian)DataView.prototype.getUint16 je metoda primerka DataView. Prebere dva zaporedna bajta, ne da bi spremenila medpomnilnik, in vrne vrednost tipa Number od 0 do vključno 65535. Če je polje predznačeno, uporabi getInt16().
byteOffset šteje bajte od začetka pogleda, ne od začetka medpomnilnika ali v 16-bitnih enotah. Poravnava ni potrebna: lih odmik je veljaven, če sta oba bajta znotraj pogleda.
Izbirni argument littleEndian se pretvori v logično vrednost. true izbere little-endian (najmanj pomembni bajt je prvi); false ali izpustitev argumenta izbere big-endian (najpomembnejši bajt je prvi). Vrstni red bajtov izberi glede na format podatkov, ne glede na arhitekturo procesorja.
Odmik se pretvori v celoštevilski indeks: undefined postane 0, neceloštevilske vrednosti pa se prirežejo proti ničli. Negativen rezultat pretvorbe sproži RangeError, prav tako branje, pri katerem oba bajta ne ležita znotraj veljavnega pogleda. TypeError nastane na primer, če this ni primerek DataView, če je medpomnilnik odklopljen ali če sam pogled po zmanjšanju medpomnilnika sega čez njegove meje.
Primeri
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);
}Rezultat
4660 13330 RangeError
Pogled se začne pri indeksu `1` v medpomnilniku, zato odmik `1` v pogledu izbere `0x12` in `0x34`. Privzeto branje vrne `4660`, branje s `true` pa `13330`. Pri odmiku `2` v pogledu ostane le še en bajt, zato koda izpiše `RangeError`.
Povezane lekcije
- JavaScript · Lekcija 2 · Napredna · Različica: 4