CKTIS / JavaScript
Dolžina in indeksiranje tipiziranih tabel
`length` šteje elemente pogleda, ne bajtov. Indeksi se začnejo z ničlo, pisanje za zadnjim elementom pa pogleda ne razširi.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
view.length
view[index]
view[index] = value
view.at(index)
new Uint16Array(buffer, byteOffset)
new Uint16Array(buffer, byteOffset, length)Tipizirana tabela, denimo Uint16Array, je pogled na medpomnilnik. view.length je podedovana lastnost z bralno, ne pa tudi nastavitveno funkcijo. Šteje elemente; view.byteLength šteje bajte pogleda, view.buffer.byteLength pa bajte celotnega medpomnilnika. Prirejanje v view.length ne spremeni velikosti pogleda in v strogem načinu sproži TypeError.
Indeksi elementov so cela števila od 0 do view.length - 1. view[0] in view["0"] označujeta isti element. Ključi, kot sta "01" in "1.0", so navadna imena lastnosti, ne indeksi elementov. view[-0] se vede kot view[0], view["-0"] pa vrne undefined.
Branje pri neveljavnem indeksu elementa vrne undefined. Pisanje pri takem indeksu ne spremeni medpomnilnika in ne doda elementa, niti v strogem načinu, če pretvorba vrednosti uspe. Pretvorba lahko vseeno sproži napako, na primer pri pisanju vrednosti Number v BigInt64Array. Pri veljavnem indeksu se vrednost shrani glede na tip elementa. view[-1] ne šteje od konca; view.at(-1) pa vrne zadnji element nepraznega pogleda.
Če konstruktor prejme ArrayBuffer s spremenljivo velikostjo ali SharedArrayBuffer, ki ga je mogoče povečati, se ob izpuščenem tretjem argumentu length (ali ob vrednosti undefined) dolžina pogleda prilagaja številu celih elementov od byteOffset do trenutnega konca medpomnilnika. Pri medpomnilniku fiksne velikosti isti klic ustvari pogled s fiksno dolžino. Število bajtov od byteOffset do konca medpomnilnika mora biti tedaj večkratnik velikosti elementa v bajtih, sicer konstruktor sproži RangeError. Izrecno podana dolžina določa število elementov, dokler je pogled znotraj meja medpomnilnika. Če pogled po zmanjšanju medpomnilnika sega čez njegove meje, length vrne 0; s ponovnim povečanjem lahko pogled spet pride znotraj meja. Tudi odklop medpomnilnika povzroči length === 0. V obeh primerih branje po indeksu vrne undefined, at() pa sproži TypeError.
Primeri
"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)}`);
}Rezultat
2 4 10 1 undefined undefined 1
Dva elementa `Uint16Array` zasedata štiri bajte. Shranjevanje `65537` da `1`, ker se ohrani le 16 najmanj pomembnih bitov. Pisanje pri indeksu `2` pogleda ne razširi; `at(-1)` prebere zadnji element.
Povezane lekcije
- JavaScript · Lekcija 33 · Napredna · Različica: 4
- JavaScript · Lekcija 34 · Napredna · Različica: 4