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

CKTIS / JavaScript

Tipizirane tabele: število elementov ter bajti pogleda in medpomnilnika

Ločite objekt medpomnilnika (`.buffer`), število elementov (`.length`), bajte pogleda (`.byteLength`) in trenutno velikost celotnega medpomnilnika (`.buffer.byteLength`).

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

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 brez kopiranja podatkov vrne isti objekt medpomnilnika: ArrayBuffer ali pri pogledu na deljeni pomnilnik SharedArrayBuffer. view.length šteje elemente, view.byteLength pa bajte v pogledu: view.length * view.BYTES_PER_ELEMENT. view.buffer.byteLength poda trenutno velikost celotnega medpomnilnika v bajtih, ne največje možne velikosti. SharedArrayBuffer ima lasten dostopnik byteLength. To so lastnosti samo za branje, ne metode.

new Uint16Array(n) rezervira prostor za n elementov. Nasprotno pa new Uint16Array(buffer, byteOffset, length) ustvari pogled brez kopiranja: odmik je izražen v bajtih, dolžina pa v elementih. Neporavnan odmik ali obseg, ki sega čez meje medpomnilnika, sproži RangeError. Če naj prejemnik dobi le podatke iz pogleda, mu posredujte kopijo njegovega obsega bajtov, ne view.buffer, ki omogoča dostop tudi do bajtov zunaj pogleda.

Pri ArrayBuffer s spremenljivo velikostjo (ECMAScript 2024) pogled brez podanega length zajema vse cele elemente, ki se prilegajo od njegovega odmika do konca medpomnilnika. Izrecno podani length določi fiksen obseg pogleda. Zmanjšanje medpomnilnika lahko povzroči, da pogled sega čez njegove meje: view.length in view.byteLength takrat vrneta 0. Po ponovnem povečanju lahko obseg spet postane veljaven. Pred uporabo preverite, ali ciljno izvajalno okolje podpira spreminjanje velikosti.

Pri prenosu ArrayBuffer na spletu se lahko prvotni medpomnilnik odklopi od podatkov. view.buffer še vedno vrne isti objekt, vendar buffer.byteLength, view.length in view.byteLength vrnejo 0. Ničla sama po sebi ne dokazuje odklopa: medpomnilnik ali pogled je lahko preprosto prazen.

Primeri

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

Rezultat

true | 3 | 6 | 16

`true | 3 | 6 | 16` potrjuje, da pogled uporablja isti medpomnilnik: od odmika 4 bajtov zajema 3 elemente po 2 bajta v 16-bajtnem medpomnilniku.

Povezane lekcije

  • JavaScript · Lekcija 5 · Napredna · Različica: 4

Viri