CKTIS / JavaScript
TypedArray: buffer, bajtový posun, veľkosť v bajtoch a počet prvkov
Rozlíšte celý buffer, rozsah pohľadu v bajtoch a počet jeho prvkov. Zistite, čo vlastnosti vracajú po zmene veľkosti alebo po odpojení buffera.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
view.buffer
view.byteOffset
view.byteLength
view.length
new Uint16Array(buffer)
new Uint16Array(buffer, byteOffset)
new Uint16Array(buffer, byteOffset, length)Inštancia ako Uint16Array je pohľad na buffer. TypedArray označuje rodinu typov; neexistuje globálny konštruktor s týmto názvom, ktorý možno priamo volať. Všetky štyri vlastnosti sú zdedené a majú getter, ale nie setter. Volanie takého gettera na objekte, ktorý nie je typovaným poľom, vyvolá TypeError. view.length nie je Uint16Array.length, ktoré označuje počet deklarovaných parametrov konštruktora.
view.buffer vráti ten istý podkladový objekt ArrayBuffer alebo SharedArrayBuffer, nie kópiu. view.byteOffset udáva začiatok pohľadu vzhľadom na začiatok buffera a view.byteLength udáva veľkosť pohľadu, oboje v bajtoch. view.length počíta prvky. Ak obe čítania zodpovedajú rovnakej veľkosti pohľadu, platí view.byteLength === view.length * view.BYTES_PER_ELEMENT. Gettery sa volajú samostatne: ak iný agent medzi čítaniami zväčší podkladový SharedArrayBuffer, gettery pohľadu s prispôsobivou dĺžkou môžu zaznamenať rôzne veľkosti a porovnanie môže vrátiť false. view.buffer.byteLength meria celý buffer, nie iba pohľad.
V new Uint16Array(buffer, byteOffset, length) je druhý argument v bajtoch a tretí v prvkoch. Posun nezarovnaný na veľkosť prvku alebo rozsah presahujúci buffer vyvolá RangeError. Zápisy sú viditeľné v prekrývajúcich sa pohľadoch na ten istý buffer. Odovzdanie pohľadu neskryje ostatné bajty: ak chcete sprístupniť len platný rozsah, skopírujte jeho bajty do samostatného buffera.
V prípade buffera s pevnou veľkosťou pokryje vynechanie length jeho zvyšok, ktorý musí obsahovať celý počet prvkov. Pri ArrayBuffer s meniteľnou veľkosťou alebo zväčšovateľnom SharedArrayBuffer vytvorí vynechanie length alebo odovzdanie undefined pohľad s prispôsobivou dĺžkou: počíta celé prvky, ktoré sa zmestia od daného posunu. Výslovne zadaný počet prvkov dĺžku pohľadu zafixuje.
Zmenšenie buffera môže dostať pohľad mimo jeho hraníc a opätovné zväčšenie ho môže vrátiť späť. Kým je pohľad mimo hraníc alebo ak bol jeho ArrayBuffer odpojený (napríklad pri prenose), všetky tri číselné gettery vracajú 0, ale buffer stále vracia ten istý objekt. Platný prázdny pohľad môže mať nenulový posun. Zmenu veľkosti a zväčšovanie špecifikuje ECMAScript 2024; overte ich podporu v cieľovom prostredí.
Príklady
{
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]));
}Výsledok
true 4 6 3 16 513
Pohľad sa začína na bajte 4 a pokrýva tri dvojbajtové prvky, teda 6 zo 16 bajtov. Zápis na index 0 je viditeľný na indexe 2 pohľadu na celý buffer.
Súvisiace lekcie
- JavaScript · Lekcia 2 · Pokročilá · Verzia: 4