Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

TypedArray: međuspremnik, bajtni pomak, veličina i broj elemenata

Razlikuj cijeli međuspremnik od raspona bajtova i broja elemenata pogleda te provjeri što svojstva vraćaju nakon promjene veličine ili odvajanja međuspremnika.

Verzija: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

view.buffer
view.byteOffset
view.byteLength
view.length

new Uint16Array(buffer)
new Uint16Array(buffer, byteOffset)
new Uint16Array(buffer, byteOffset, length)

Instanca poput Uint16Array pogled je na međuspremnik. TypedArray označava obitelj tipova; ne postoji globalni konstruktor tog naziva koji možeš izravno pozvati. Četiri su svojstva naslijeđena i imaju getter, ali ne setter. Pozivanje takvog gettera na objektu koji nije tipizirano polje izaziva TypeError. view.length nije Uint16Array.length, koji označava broj deklariranih parametara konstruktora.

view.buffer vraća isti temeljni objekt ArrayBuffer ili SharedArrayBuffer, a ne kopiju. view.byteOffset označava početak pogleda u odnosu na početak međuspremnika, a view.byteLength veličinu pogleda, oboje u bajtovima. view.length broji elemente. Ako oba čitanja odražavaju istu veličinu pogleda, vrijedi view.byteLength === view.length * view.BYTES_PER_ELEMENT. Getteri se pozivaju odvojeno: ako drugi agent između čitanja poveća temeljni SharedArrayBuffer, getteri pogleda prilagodljive duljine mogu očitati različite veličine i usporedba može vratiti false. view.buffer.byteLength mjeri cijeli međuspremnik, a ne samo pogled.

U new Uint16Array(buffer, byteOffset, length) drugi je argument u bajtovima, a treći u elementima. Pomak koji nije poravnat s veličinom elementa ili raspon koji izlazi izvan međuspremnika izaziva RangeError. Upisi su vidljivi u preklapajućim pogledima na isti međuspremnik. Prosljeđivanje pogleda ne skriva ostale bajtove: ako želiš otkriti samo valjani raspon, kopiraj njegove bajtove u zaseban međuspremnik.

U međuspremniku fiksne veličine izostavljanje length obuhvaća ostatak, u koji mora stati cijeli broj elemenata. U ArrayBuffer promjenjive veličine ili proširivom SharedArrayBuffer izostavljanje length ili prosljeđivanje undefined stvara pogled prilagodljive duljine: on broji cijele elemente koji stanu od zadanog pomaka. Izričito zadan broj elemenata fiksira duljinu pogleda.

Smanjivanje međuspremnika može izbaciti pogled izvan granica, a ponovno povećavanje može ga vratiti unutar njih. Ako je pogled izvan granica ili je njegov ArrayBuffer odvojen (primjerice pri prijenosu), sva tri brojčana gettera vraćaju 0, ali buffer i dalje vraća isti objekt. Valjan prazan pogled može imati pomak različit od nule. Promjena veličine i proširivanje definirani su u ECMAScriptu 2024; provjeri podršku u ciljnom izvršnom okruženju.

Primjeri

{
  const buffer = new ArrayBuffer(16);
  const view = new Uint16Array(buffer, 4, 3);

  console.log([
    view.buffer === buffer,
    view.byteOffset,
    view.byteLength,
    view.length,
    view.buffer.byteLength,
  ].join(" "));

  view[0] = 513;
  console.log(String(new Uint16Array(buffer)[2]));
}

Rezultat

true 4 6 3 16
513

Pogled počinje na bajtu 4 i obuhvaća tri dvobajtna elementa, odnosno 6 od 16 bajtova. Upis na indeksu 0 vidljiv je na indeksu 2 pogleda na cijeli međuspremnik.

Povezane lekcije

  • JavaScript · Lekcija 2 · Napredno · Verzija: 4

Izvori