Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Délka a indexování typovaných polí

`length` udává počet prvků pohledu, nikoli počet bajtů. Indexy začínají nulou a zápisem za poslední prvek se pohled nerozšíří.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

view.length
view[index]
view[index] = value
view.at(index)
new Uint16Array(buffer, byteOffset)
new Uint16Array(buffer, byteOffset, length)

Typované pole, například Uint16Array, je pohled na buffer. view.length je zděděná vlastnost s getterem bez setteru. Udává počet prvků; view.byteLength udává počet bajtů pohledu a view.buffer.byteLength počet bajtů celého bufferu. Přiřazení do view.length velikost pohledu nezmění a v přísném režimu vyvolá TypeError.

Indexy prvků jsou celá čísla od 0 do view.length - 1. view[0] a view["0"] označují stejný prvek. Klíče jako "01" a "1.0" jsou běžné názvy vlastností, nikoli indexy prvků. view[-0] se chová stejně jako view[0], ale view["-0"] vrací undefined.

Čtení na neplatném indexu prvku vrací undefined. Zápis na takový index nezmění buffer ani nepřidá prvek, a to ani v přísném režimu, pokud převod hodnoty proběhne úspěšně. Převod však může vyvolat chybu, například při zápisu hodnoty Number do BigInt64Array. Na platném indexu se hodnota uloží podle typu prvku. view[-1] nepočítá od konce; view.at(-1) ano a vrací poslední prvek neprázdného pohledu.

Pokud konstruktor dostane ArrayBuffer s měnitelnou velikostí nebo SharedArrayBuffer, který lze zvětšovat, při vynechání třetího argumentu length (nebo při předání undefined) se délka pohledu přizpůsobuje počtu celých prvků od byteOffset po aktuální konec bufferu. U bufferu s pevnou velikostí stejné volání vytvoří pohled s pevnou délkou. Počet bajtů od byteOffset do konce bufferu pak musí být násobkem velikosti prvku v bajtech; jinak konstruktor vyvolá RangeError. Výslovně zadaná délka určuje pevný počet prvků, dokud se pohled do bufferu vejde. Pokud se po zmenšení nevejde, length vrací 0; opětovné zvětšení může pohled vrátit do rozsahu bufferu. Také odpojení bufferu způsobí length === 0. V obou případech čtení podle indexu vrací undefined, ale at() vyvolá TypeError.

Pří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ýsledek

2 4
10 1
undefined undefined 1

Dva prvky `Uint16Array` zabírají čtyři bajty. Uložením `65537` vznikne `1`, protože se zachová jen 16 nejméně významných bitů. Zápis na index `2` pohled nerozšíří; `at(-1)` přečte poslední prvek.

Související lekce

  • JavaScript · Lekce 33 · Pokročilá · Verze: 4
  • JavaScript · Lekce 34 · Pokročilá · Verze: 4

Zdroje