CKTIS / JavaScript
Dĺžka a indexovanie typovaných polí
`length` udáva počet prvkov pohľadu, nie počet bajtov. Indexy začínajú nulou a zápis za posledný prvok pohľad nerozšíri.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
view.length
view[index]
view[index] = value
view.at(index)
new Uint16Array(buffer, byteOffset)
new Uint16Array(buffer, byteOffset, length)Typované pole, napríklad Uint16Array, je pohľad na buffer. view.length je zdedená vlastnosť s getterom bez settera. Udáva počet prvkov; view.byteLength udáva počet bajtov pohľadu a view.buffer.byteLength počet bajtov celého buffera. Priradenie do view.length nezmení veľkosť pohľadu a v prísnom režime vyvolá TypeError.
Indexy prvkov sú celé čísla od 0 po view.length - 1. view[0] a view["0"] označujú ten istý prvok. Kľúče ako "01" a "1.0" sú bežné názvy vlastností, nie indexy prvkov. view[-0] sa správa ako view[0], ale view["-0"] vráti undefined.
Čítanie na neplatnom indexe prvku vráti undefined. Zápis na taký index nezmení buffer ani nepridá prvok, a to ani v prísnom režime, ak sa prevod hodnoty podarí. Prevod však môže vyvolať chybu, napríklad pri zápise hodnoty Number do BigInt64Array. Na platnom indexe sa hodnota uloží podľa typu prvku. view[-1] nepočíta od konca; view.at(-1) áno a vráti posledný prvok neprázdneho pohľadu.
Ak behové prostredie podporuje buffery s meniteľnou veľkosťou, konštruktor môže dostať ArrayBuffer s meniteľnou veľkosťou alebo SharedArrayBuffer, ktorý možno zväčšovať. Pri takomto bufferi vynechanie tretieho argumentu length (alebo odovzdanie undefined) vytvorí pohľad, ktorého dĺžka sa prispôsobuje počtu celých prvkov od byteOffset po aktuálny koniec buffera. Pri bufferi s pevnou veľkosťou rovnaké volanie vytvorí pohľad s pevnou dĺžkou. Počet bajtov od byteOffset po koniec buffera musí byť v tomto prípade násobkom veľkosti prvku v bajtoch, inak konštruktor vyvolá RangeError. Výslovne zadaná dĺžka určuje pevný počet prvkov, kým sa pohľad zmestí do buffera. Ak sa po zmenšení nezmestí, length vráti 0; opätovné zväčšenie môže pohľad vrátiť do rozsahu buffera. Aj odpojenie buffera spôsobí length === 0. V oboch prípadoch čítanie podľa indexu vráti undefined, ale at() vyvolá TypeError.
Príklady
"use strict";
{
const view = new Uint16Array([10, 20]);
view[1] = 65537;
view[view.length] = 99;
console.log(`${view.length} ${view.byteLength}`);
console.log(`${view[0]} ${view[1]}`);
console.log(`${view[view.length]} ${view[-1]} ${view.at(-1)}`);
}Výsledok
2 4 10 1 undefined undefined 1
Dva prvky `Uint16Array` zaberajú štyri bajty. Uložením `65537` vznikne `1`, pretože sa zachová len 16 najmenej významných bitov. Zápis na index `2` pohľad nerozšíri; `at(-1)` prečíta posledný prvok.
Súvisiace lekcie
- JavaScript · Lekcia 33 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 34 · Pokročilá · Verzia: 4