CKTIS / JavaScript
TypedArray: medpomnilnik, bajtni odmik, velikost in število elementov
Loči celoten medpomnilnik od obsega pogleda v bajtih in števila njegovih elementov. Preveri, kaj vrnejo lastnosti po spremembi velikosti ali odklopu medpomnilnika.
Različica: 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)Primerek, kot je Uint16Array, je pogled na medpomnilnik. TypedArray je ime družine tipov, ne globalni konstruktor, ki bi ga lahko neposredno poklical. Štiri lastnosti so podedovane in imajo bralni, ne pa nastavitvenega dostopnika. Klic bralnega dostopnika na objektu, ki ni tipizirana tabela, sproži TypeError. view.length ni isto kot Uint16Array.length, ki označuje število deklariranih parametrov konstruktorja.
view.buffer vrne isti osnovni objekt ArrayBuffer ali SharedArrayBuffer, ne kopije. view.byteOffset je odmik začetka pogleda od začetka medpomnilnika, view.byteLength pa njegova velikost, oboje v bajtih. view.length šteje elemente. Če obe branji odražata isto velikost pogleda, velja view.byteLength === view.length * view.BYTES_PER_ELEMENT. Bralna dostopnika se kličeta ločeno: če drug agent med branji poveča osnovni SharedArrayBuffer, lahko dostopnika pogleda s prilagodljivo dolžino zaznata različni velikosti in primerjava lahko vrne false. view.buffer.byteLength meri celoten medpomnilnik, ne le pogleda.
V new Uint16Array(buffer, byteOffset, length) je drugi argument v bajtih, tretji pa v elementih. Odmik, ki ni poravnan z velikostjo elementa, ali obseg, ki sega čez medpomnilnik, sproži RangeError. Zapisi so vidni v prekrivajočih se pogledih na isti medpomnilnik. Če posreduješ pogled, s tem ne skriješ preostalih bajtov: če želiš razkriti le veljaven obseg, njegove bajte kopiraj v ločen medpomnilnik.
Pri medpomnilniku nespremenljive velikosti izpustitev length zajame preostanek, ki mora vsebovati celo število elementov. Pri ArrayBuffer s spremenljivo velikostjo ali razširljivem SharedArrayBuffer izpustitev length ali podani undefined ustvari pogled s prilagodljivo dolžino: šteje cele elemente, ki se prilegajo od odmika naprej. Izrecno število elementov določi fiksno dolžino pogleda.
Zmanjšanje medpomnilnika lahko potisne pogled izven meja, ponovno povečanje pa ga lahko vrne znotraj meja. Če je pogled izven meja ali je njegov ArrayBuffer odklopljen (na primer pri prenosu), vsi trije številski dostopniki vrnejo 0, buffer pa še vedno vrne isti objekt. Veljaven prazen pogled ima lahko odmik, različen od nič. Spreminjanje velikosti in povečevanje določa ECMAScript 2024; preveri podporo v ciljnem izvajalnem okolju.
Primeri
{
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 se začne pri bajtu 4 in zajema tri dvobajtne elemente, torej 6 od 16 bajtov. Zapis na indeks 0 je viden na indeksu 2 pogleda na celoten medpomnilnik.
Povezane lekcije
- JavaScript · Lekcija 2 · Napredna · Različica: 4