CKTIS / JavaScript
Typované polia: pohľad cez `subarray()` a kópia cez `slice()`
`subarray()` vytvorí pohľad na ten istý buffer, kým `slice()` predvolene skopíruje vybrané prvky do samostatného buffera. Obe metódy vyhodnocujú hranice rovnako.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
typedArray.subarray()
typedArray.subarray(start)
typedArray.subarray(start, end)
typedArray.slice()
typedArray.slice(start)
typedArray.slice(start, end)subarray() a slice() sú metódy spoločného prototypu, ktoré dedia inštancie ako Uint16Array. Globálny konštruktor TypedArray neexistuje. Obe metódy vyžadujú ako this skutočné typované pole; obyčajné pole Array spôsobí TypeError.
Obe metódy používajú indexy prvkov v pohľade od nuly, nie pozície bajtov v bufferi ako ArrayBuffer.prototype.slice(). Začiatok je zahrnutý a koniec nie. Ak je start vynechaný alebo má hodnotu undefined, použije sa 0; ak je end vynechaný alebo má hodnotu undefined, použije sa koniec pohľadu. Zlomkové časti sa odrežú smerom k nule, záporné indexy sa počítajú od konca a hranice sa obmedzia na interval od 0 po dĺžku pohľadu. Ak vypočítaný koniec leží na začiatku alebo pred ním, obe metódy vrátia pre platný pohľad na buffer s pevnou veľkosťou prázdne typované pole, ak sa použije predvolený konštruktor výsledku. Vlastný konštruktor nastavený pomocou constructor[Symbol.species] môže vrátiť neprázdne typované pole, aj keď je požadovaná dĺžka 0.
S predvoleným konštruktorom výsledku vytvorí subarray() nový pohľad na ten istý buffer bez kopírovania prvkov. Zápisy v prekrývajúcej sa oblasti sú viditeľné v oboch pohľadoch. Aj malý pohľad môže udržať v pamäti celý buffer a jeho .buffer sprístupňuje bajty mimo vybraného rozsahu. Ak potrebuješ nezávislú kópiu vybraných prvkov, použi slice(). Vlastný constructor[Symbol.species] môže spustiť kód, zmeniť typ prvkov alebo ovplyvniť, či výsledok zdieľa pamäť. Tieto metódy nepovažuj za bezpečnostnú hranicu pre nedôveryhodné objekty.
V ECMAScripte 2024 sa s predvoleným konštruktorom dĺžka výsledného pohľadu z subarray() prispôsobuje veľkosti buffera, ak to robí aj zdrojový pohľad a end je vynechaný alebo má hodnotu undefined. Iná hodnota end vytvorí pohľad s pevnou dĺžkou; slice() predvolene vytvorí kópiu s pevnou dĺžkou. Ak je buffer pri volaní odpojený alebo zdrojový pohľad už presahuje jeho hranice, slice() vyvolá TypeError. subarray() vtedy počíta s dĺžkou zdroja 0, ale vytvorenie výsledku môže aj tak zlyhať. Over, či cieľové prostredie podporuje buffery s meniteľnou veľkosťou.
Prí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ýsledok
source: 10, 99, 77, 40 view: 99, 77 copy: 20, 30 same buffer: true, false
`(1, -1)` vyberie `20` a `30`. Zápis cez `view` zmení `source` a zápis cez `source` zmení `view`. `copy` si ponechá `20, 30` a má samostatný buffer.
Súvisiace lekcie
- JavaScript · Lekcia 2 · Pokročilá · Verzia: 4
Zdroje
- ECMAScript® 2024 Language Specification — %TypedArray%.prototype.subarray
- ECMAScript® 2024 Language Specification — %TypedArray%.prototype.slice
- ECMAScript® 2024 Language Specification — TypedArraySpeciesCreate
- TypedArray.prototype.subarray() - JavaScript | MDN
- TypedArray.prototype.slice() - JavaScript | MDN
- TypedArray - JavaScript | MDN
- TypedArray[Symbol.species] - JavaScript | MDN
- ArrayBuffer.prototype.slice() - JavaScript | MDN