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
- 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