Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Typované polia: počet prvkov, bajty pohľadu a bajty buffera

Rozlišujte objekt buffera (`.buffer`), počet prvkov (`.length`), veľkosť pohľadu v bajtoch (`.byteLength`) a aktuálnu veľkosť celého buffera (`.buffer.byteLength`).

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

Syntax

const buffer = new ArrayBuffer(byteCount);
const view = new Uint16Array(buffer, byteOffset, elementCount);
view.buffer       // backing buffer object
view.length       // element count in the view
view.byteLength   // byte count in the view
buffer.byteLength // current byte count of the entire buffer

view.buffer vracia ten istý objekt buffera bez kopírovania údajov: ArrayBuffer alebo pri pohľade na zdieľanú pamäť SharedArrayBuffer. view.length udáva počet prvkov, kým view.byteLength počet bajtov pohľadu: view.length * view.BYTES_PER_ELEMENT. view.buffer.byteLength udáva aktuálnu veľkosť celého buffera v bajtoch, nie jeho maximum. SharedArrayBuffer má vlastný getter byteLength. Ide o vlastnosti len na čítanie, nie o metódy.

new Uint16Array(n) vyhradí pamäť pre n prvkov. Naproti tomu new Uint16Array(buffer, byteOffset, length) vytvorí pohľad bez kopírovania: posun je v bajtoch a dĺžka v prvkoch. Nesprávne zarovnaný posun alebo rozsah presahujúci hranice buffera vyvolá RangeError. Ak má príjemca dostať len údaje pohľadu, odovzdajte kópiu jeho rozsahu bajtov, nie view.buffer, ktorý sprístupňuje aj bajty mimo pohľadu.

Pri ArrayBuffer, ktorého veľkosť možno meniť (ECMAScript 2024), pohľad bez zadania length zahŕňa všetky celé prvky, ktoré sa zmestia od jeho posunu po koniec buffera. Výslovne zadané length rozsah pohľadu zafixuje. Zmenšením buffera sa môže pohľad dostať mimo jeho hraníc: view.length a view.byteLength vtedy vracajú 0. Opätovným zväčšením môže byť rozsah znovu platný. Pred použitím si overte podporu zmeny veľkosti v cieľovom prostredí.

Prenos ArrayBuffer na webe môže odpojiť pôvodný buffer od jeho údajov. view.buffer naďalej vracia ten istý objekt, ale buffer.byteLength, view.length a view.byteLength vracajú 0. Samotná nula nedokazuje odpojenie: buffer alebo pohľad môže byť jednoducho prázdny.

Príklady

{
  const buffer = new ArrayBuffer(16);
  const view = new Uint16Array(buffer, 4, 3);
  console.log(`${view.buffer === buffer} | ${view.length} | ${view.byteLength} | ${buffer.byteLength}`);
}

Výsledok

true | 3 | 6 | 16

`true | 3 | 6 | 16` potvrdzuje, že pohľad používa ten istý buffer: od bajtového posunu 4 zahŕňa 3 prvky po 2 bajtoch v 16-bajtovom bufferi.

Súvisiace lekcie

  • JavaScript · Lekcia 5 · Pokročilá · Verzia: 4

Zdroje