CKTIS / JavaScript
TypedArray: buffer, bajtový posun, velikost v bajtech a počet prvků
Rozlišujte celý buffer, rozsah pohledu v bajtech a počet jeho prvků. Zjistěte, co vlastnosti vracejí po změně velikosti nebo po odpojení bufferu.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
view.buffer
view.byteOffset
view.byteLength
view.length
new Uint16Array(buffer)
new Uint16Array(buffer, byteOffset)
new Uint16Array(buffer, byteOffset, length)Instance jako Uint16Array je pohled na buffer. TypedArray označuje rodinu typů; neexistuje globální konstruktor tohoto jména, který by šlo přímo volat. Všechny čtyři vlastnosti jsou zděděné a mají getter, ale ne setter. Vyvolání takového getteru nad objektem, který není typovaným polem, způsobí TypeError. view.length není totéž co Uint16Array.length, které udává počet deklarovaných parametrů konstruktoru.
view.buffer vrací tentýž podkladový objekt ArrayBuffer nebo SharedArrayBuffer, nikoli kopii. view.byteOffset udává začátek pohledu vzhledem k začátku bufferu a view.byteLength velikost pohledu, obojí v bajtech. view.length počítá prvky. Pokud obě čtení odpovídají stejné velikosti pohledu, platí view.byteLength === view.length * view.BYTES_PER_ELEMENT. Gettery se volají samostatně: pokud jiný agent mezi čteními zvětší podkladový SharedArrayBuffer, gettery pohledu s přizpůsobivou délkou mohou zaznamenat různé velikosti a porovnání může vrátit false. view.buffer.byteLength měří celý buffer, nejen pohled.
V new Uint16Array(buffer, byteOffset, length) je druhý argument v bajtech a třetí v prvcích. Posun nezarovnaný na velikost prvku nebo rozsah přesahující buffer způsobí RangeError. Zápisy jsou viditelné v překrývajících se pohledech na tentýž buffer. Předání pohledu nezakryje ostatní bajty: chcete-li zpřístupnit jen platný rozsah, zkopírujte jeho bajty do samostatného bufferu.
U bufferu s pevnou velikostí pokryje vynechání length jeho zbytek, který musí obsahovat celý počet prvků. U ArrayBuffer s měnitelnou velikostí nebo zvětšovatelného SharedArrayBuffer vytvoří vynechání length nebo předání undefined pohled s přizpůsobivou délkou: počítá celé prvky, které se vejdou od daného posunu. Výslovný počet prvků délku pohledu zafixuje.
Zmenšení bufferu může dostat pohled mimo jeho hranice a opětovné zvětšení ho může vrátit zpět. Dokud je pohled mimo hranice nebo pokud byl jeho ArrayBuffer odpojen (například při přenosu), všechny tři číselné gettery vracejí 0, ale buffer stále vrací tentýž objekt. Platný prázdný pohled může mít nenulový posun. Změnu velikosti i zvětšování specifikuje ECMAScript 2024; ověřte jejich podporu v cílovém prostředí.
Pří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ýsledek
true 4 6 3 16 513
Pohled začíná na bajtu 4 a pokrývá tři dvoubajtové prvky, tedy 6 ze 16 bajtů. Zápis na index 0 je vidět na indexu 2 pohledu na celý buffer.
Související lekce
- JavaScript · Lekce 2 · Pokročilá · Verze: 4