Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

TypedArray: velikosti, indeksiranje, pogledi in kopije

Spoznajte razliko med številom elementov in številom bajtov v TypedArray. Oglejte si, kako buffer in byteOffset opisujeta pogled ter zakaj subarray() deli podatke, slice() pa ustvari neodvisno kopijo.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

const view = new Uint16Array(buffer, byteOffset, length);
view.length; view.byteLength; view.buffer; view.byteOffset;
view[index]; view[index] = value;
view.subarray(begin, end);
view.slice(start, end);

TypedArray je skupni vmesnik za tipizirane poglede na binarne podatke, ne pa globalno dostopen konstruktor. Uporabite konkreten tip, na primer Uint16Array. Ti API-ji so del ECMAScripta in ne zahtevajo DOM-a. Tukaj TypedArray.length, TypedArray.byteLength, TypedArray.buffer in TypedArray.byteOffset označujejo lastnosti primerka, kot je view.length, ne pa statičnih lastnosti.

length šteje elemente, byteLength šteje bajte pogleda, buffer se sklicuje na celoten osnovni ArrayBuffer ali SharedArrayBuffer, byteOffset pa določa začetek pogleda v bajtih glede na medpomnilnik. Za veljaven pogled velja byteLength === length * BYTES_PER_ELEMENT. Pogled lahko zajema le del medpomnilnika. V new Uint16Array(buffer, byteOffset, length) mora biti odmik večkratnik števila 2, medtem ko length še vedno šteje elemente. Te lastnosti so samo za branje; sprememba velikosti medpomnilnika lahko kljub temu spremeni prikazane velikosti, pogled zunaj obsega pa prikazuje velikosti in odmik kot nič.

TypedArray.indexing označuje sintakso view[index], ne metode. Indeksi se začnejo z nič in določajo elemente glede na začetek pogleda. Pri prirejanju se vrednost pretvori v tip elementa. Branje zunaj obsega vrne undefined; pisanje zunaj obsega pogleda ne poveča in ne shrani vrednosti. view[-1] ne prebere zadnjega elementa.

TypedArray.prototype.subarray(begin, end) ustvari nov pogled, ki si deli medpomnilnik: spremembe prekrivajočih se elementov so vidne v obeh pogledih. TypedArray.prototype.slice(start, end) kopira izbrane elemente v neodvisen medpomnilnik. Obe metodi določata meje v elementih, vključita začetek in izključita konec; negativne meje se štejejo od konca, izpuščeni konec pa pomeni konec pogleda. Ta pravila opisujejo običajne vgrajene tipe; lastni podrazredi lahko ustvarjanje rezultatov spremenijo prek Symbol.species.

Primeri

const buffer = new ArrayBuffer(12);
const view = new Uint16Array(buffer, 2, 4);
view.set([10, 20, 30, 40]);
const shared = view.subarray(1, 3);
const copied = view.slice(1, 3);
shared[0] = 99;
console.log(view.length, view.byteLength, view.byteOffset, buffer.byteLength);
console.log(shared.byteOffset, shared.buffer === view.buffer, copied.buffer === view.buffer);
console.log(view.join(','));
console.log(shared.join(','));
console.log(copied.join(','));
view[4] = 50;
console.log(view[4], view.length);

Rezultat

4 8 2 12
4 true false
10,99,30,40
99,30
20,30
undefined 4

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri