CKTIS / JavaScript
TypedArray: veličine, indeksiranje, pogledi i kopije
Upoznajte razliku između broja elemenata i broja bajtova u TypedArray. Saznajte kako buffer i byteOffset opisuju pogled te zašto subarray() dijeli podatke, dok slice() stvara neovisnu kopiju.
Verzija: 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 zajedničko sučelje tipiziranih pogleda na binarne podatke, a ne globalno dostupan konstruktor. Upotrijebite konkretan tip kao što je Uint16Array. Ovi API-ji pripadaju ECMAScriptu i ne zahtijevaju DOM. Ovdje TypedArray.length, TypedArray.byteLength, TypedArray.buffer i TypedArray.byteOffset označavaju svojstva instance, primjerice view.length, a ne statička svojstva.
length broji elemente, byteLength broji bajtove pogleda, buffer upućuje na cijeli temeljni ArrayBuffer ili SharedArrayBuffer, a byteOffset određuje početak pogleda u bajtovima u odnosu na međuspremnik. Za valjan pogled vrijedi byteLength === length * BYTES_PER_ELEMENT. Pogled može obuhvaćati samo dio međuspremnika. U new Uint16Array(buffer, byteOffset, length) pomak mora biti višekratnik broja 2, dok length i dalje broji elemente. Ta su svojstva samo za čitanje; promjena veličine međuspremnika ipak može promijeniti prijavljene veličine, a pogled izvan raspona prijavljuje nulte veličine i pomak.
TypedArray.indexing označava sintaksu view[index], a ne metodu. Indeksi počinju od nule i odnose se na elemente u odnosu na početak pogleda. Dodjelom se vrijednost pretvara u tip elementa. Čitanje izvan raspona vraća undefined; pisanje izvan raspona ne povećava pogled niti pohranjuje vrijednost. view[-1] ne čita posljednji element.
TypedArray.prototype.subarray(begin, end) stvara novi pogled koji dijeli međuspremnik: promjene preklapajućih elemenata vidljive su u oba pogleda. TypedArray.prototype.slice(start, end) kopira odabrane elemente u neovisan međuspremnik. Obje metode određuju granice u elementima, uključuju početak i isključuju kraj; negativne se granice računaju od kraja, a izostavljeni kraj znači kraj pogleda. Ova pravila opisuju uobičajene ugrađene tipove; prilagođene podklase mogu promijeniti stvaranje rezultata pomoću Symbol.species.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.