CKTIS / JavaScript
DataView.prototype.getUint16(): čitanje 16-bitnog cijelog broja bez predznaka
Pročitaj dva bajta iz pogleda DataView kao 16-bitni cijeli broj bez predznaka, redoslijedom bajtova koji određuje format podataka.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
view.getUint16(byteOffset)
view.getUint16(byteOffset, littleEndian)DataView.prototype.getUint16 metoda je instance DataView. Čita dva uzastopna bajta bez izmjene međuspremnika i vraća vrijednost tipa Number od 0 do uključivo 65535. Ako polje ima predznak, upotrijebi getInt16().
byteOffset broji bajtove od početka pogleda, a ne od početka međuspremnika ili u 16-bitnim jedinicama. Poravnanje nije potrebno: neparan pomak valjan je ako oba bajta stanu u pogled.
Neobvezni argument littleEndian pretvara se u logičku vrijednost. true odabire little-endian (prvo ide bajt najmanje težine), a false ili izostavljanje argumenta odabire big-endian (prvo ide bajt najveće težine). Redoslijed bajtova odaberi prema formatu podataka, a ne prema arhitekturi procesora.
Pomak se pretvara u cjelobrojni indeks: undefined postaje 0, a vrijednosti s razlomljenim dijelom skraćuju se prema nuli. Negativan rezultat pretvorbe izaziva RangeError, baš kao i čitanje pri kojem oba bajta ne stanu u valjani pogled. TypeError nastaje, primjerice, ako this nije instanca objekta DataView, ako je međuspremnik odvojen ili ako sam pogled nakon smanjenja međuspremnika prelazi njegove granice.
Primjeri
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 počinje na indeksu `1` u međuspremniku, pa pomak `1` unutar pogleda odabire `0x12` i `0x34`. Zadano čitanje vraća `4660`, a čitanje s `true` vraća `13330`. Na pomaku `2` u pogledu je preostao samo jedan bajt pa kôd ispisuje `RangeError`.
Povezane lekcije
- JavaScript · Lekcija 2 · Napredno · Verzija: 4