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

CKTIS / JavaScript

Typovaná pole: pohled pomocí `subarray()` a kopie pomocí `slice()`

`subarray()` vytvoří pohled na stejný buffer, zatímco `slice()` ve výchozím nastavení zkopíruje vybrané prvky do samostatného bufferu. Obě metody vyhodnocují meze stejně.

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

Syntaxe

typedArray.subarray()
typedArray.subarray(start)
typedArray.subarray(start, end)
typedArray.slice()
typedArray.slice(start)
typedArray.slice(start, end)

subarray() a slice() jsou metody společného prototypu, které dědí instance jako Uint16Array. Globální konstruktor TypedArray neexistuje. Obě metody vyžadují skutečné typované pole jako this; obyčejné pole Array vyvolá TypeError.

Obě metody používají indexy prvků v pohledu od nuly, nikoli pozice bajtů v bufferu jako ArrayBuffer.prototype.slice(). Začátek do rozsahu patří, konec ne. Je-li start vynechaný nebo má hodnotu undefined, použije se 0; je-li end vynechaný nebo má hodnotu undefined, použije se konec pohledu. Zlomkové části se odříznou směrem k nule, záporné indexy se počítají od konce a meze se omezí na interval od 0 do délky pohledu. Pokud vypočtený konec leží na začátku nebo před ním, vrátí obě metody pro platný pohled na buffer s pevnou velikostí prázdné typované pole, použije-li se výchozí konstruktor výsledku. Vlastní konstruktor určený pomocí constructor[Symbol.species] může vrátit neprázdné typované pole, i když je požadovaná délka 0.

S výchozím konstruktorem výsledku vytvoří subarray() nový pohled na stejný buffer bez kopírování prvků. Zápisy v překrývající se oblasti jsou vidět v obou pohledech. I malý pohled může udržovat v paměti celý buffer a jeho .buffer zpřístupňuje bajty mimo vybraný rozsah. Pro nezávislou kopii vybraných prvků použijte slice(). Vlastní constructor[Symbol.species] může spustit kód, změnit typ prvků nebo ovlivnit, zda výsledek sdílí paměť. Nepovažujte tyto metody za bezpečnostní hranici pro nedůvěryhodné objekty.

V ECMAScriptu 2024 se s výchozím konstruktorem délka pohledu z subarray() přizpůsobuje velikosti bufferu, pokud to dělá i zdrojový pohled a end je vynechaný nebo má hodnotu undefined. Jiná hodnota end dá pohled s pevnou délkou; slice() ve výchozím nastavení vrací kopii s pevnou délkou. Je-li buffer při volání odpojený nebo zdrojový pohled už přesahuje jeho meze, slice() vyvolá TypeError. subarray() v takovém případě počítá s délkou zdroje 0, ale vytvoření výsledku přesto může selhat. Ověřte podporu bufferů s měnitelnou velikostí v cílovém prostředí.

Příklady

{
  const source = new Uint16Array([10, 20, 30, 40]);
  const view = source.subarray(1, -1);
  const copy = source.slice(1, -1);

  view[0] = 99;
  source[2] = 77;

  console.log(`source: ${source.join(', ')}`);
  console.log(`view: ${view.join(', ')}`);
  console.log(`copy: ${copy.join(', ')}`);
  console.log(`same buffer: ${view.buffer === source.buffer}, ${copy.buffer === source.buffer}`);
}

Výsledek

source: 10, 99, 77, 40
view: 99, 77
copy: 20, 30
same buffer: true, false

`(1, -1)` vybere `20` a `30`. Zápis přes `view` změní `source` a zápis přes `source` změní `view`. `copy` si zachová `20, 30` a má samostatný buffer.

Související lekce

  • JavaScript · Lekce 2 · Pokročilá · Verze: 4

Zdroje