Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Duljina i indeksiranje tipiziranih polja

`length` broji elemente pogleda, a ne bajtove. Indeksi počinju od nule, a upis iza posljednjeg elementa ne proširuje pogled.

Verzija: 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)

Tipizirano polje, primjerice Uint16Array, pogled je na međuspremnik. view.length je naslijeđeno svojstvo s getterom, ali bez settera. Broji elemente; view.byteLength broji bajtove pogleda, a view.buffer.byteLength bajtove cijelog međuspremnika. Dodjela vrijednosti svojstvu view.length ne mijenja veličinu pogleda i u strogom načinu rada izaziva TypeError.

Indeksi elemenata cijeli su brojevi od 0 do view.length - 1. view[0] i view["0"] označavaju isti element. Ključevi poput "01" i "1.0" obični su nazivi svojstava, a ne indeksi elemenata. view[-0] ponaša se kao view[0], ali view["-0"] vraća undefined.

Čitanje na nevaljanom indeksu elementa vraća undefined. Upis na takav indeks ne mijenja međuspremnik niti dodaje element, čak ni u strogom načinu rada, ako pretvorba vrijednosti uspije. Pretvorba ipak može izazvati pogrešku, primjerice pri upisu vrijednosti Number u BigInt64Array. Na valjanom indeksu vrijednost se pohranjuje prema tipu elementa. view[-1] ne broji od kraja; view.at(-1) broji i vraća posljednji element nepraznog pogleda.

Ako konstruktor primi ArrayBuffer promjenjive veličine ili SharedArrayBuffer koji se može povećavati, izostavljanje trećeg argumenta length (ili prosljeđivanje undefined) stvara pogled čija se duljina prilagođava broju cijelih elemenata od byteOffset do trenutačnog kraja međuspremnika. Za međuspremnik fiksne veličine isti poziv stvara pogled fiksne duljine. U tom slučaju broj bajtova od byteOffset do kraja međuspremnika mora biti višekratnik veličine elementa u bajtovima; u suprotnom konstruktor izaziva RangeError. Izričito zadana duljina određuje broj elemenata dok god pogled stane u međuspremnik. Ako nakon smanjivanja pogled izađe izvan njegovih granica, length vraća 0; ponovno povećanje može vratiti pogled unutar granica. Odvajanje međuspremnika također daje length === 0. U oba slučaja čitanje po indeksu vraća undefined, ali at() izaziva TypeError.

Primjeri

"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 polja `Uint16Array` zauzimaju četiri bajta. Pohranom vrijednosti `65537` dobiva se `1` jer se zadržava samo 16 bitova najmanje težine. Upis na indeks `2` ne proširuje pogled; `at(-1)` čita posljednji element.

Povezane lekcije

  • JavaScript · Lekcija 33 · Napredno · Verzija: 4
  • JavaScript · Lekcija 34 · Napredno · Verzija: 4

Izvori