CKTIS / JavaScript
Getypeerde arrays: weergave met `subarray()`, kopie met `slice()`
`subarray()` maakt een weergave van dezelfde buffer; `slice()` kopieert standaard de gekozen elementen naar een aparte buffer. Beide interpreteren de grenzen op dezelfde manier.
Versie: 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() en slice() zijn methoden van het gedeelde prototype dat instanties zoals Uint16Array overerven. Er is geen globale constructor TypedArray. Beide methoden vereisen een echte getypeerde array als this; een gewone Array veroorzaakt een TypeError.
Beide gebruiken elementindices vanaf nul binnen de weergave, geen byteposities in de buffer zoals ArrayBuffer.prototype.slice(). Het begin telt mee, het einde niet. Bij weglaten of undefined geldt 0 voor start en het einde van de weergave voor end. Breuken worden afgekapt richting nul, negatieve indices tellen vanaf het einde en de grenzen worden beperkt tot het bereik van 0 tot de lengte van de weergave. Valt het berekende einde op of vóór het begin, dan geven beide methoden bij een geldige weergave van een buffer met vaste grootte een lege getypeerde array terug als ze de standaardconstructor voor het resultaat gebruiken. Een aangepaste constructor die via constructor[Symbol.species] is ingesteld, kan een niet-lege getypeerde array teruggeven, zelfs als de gevraagde lengte 0 is.
Met de standaardconstructor voor het resultaat maakt subarray() een nieuwe weergave van dezelfde buffer zonder elementen te kopiëren. Wijzigingen in het overlappende gebied zijn in beide weergaven zichtbaar. Zelfs een kleine weergave kan de volledige buffer in het geheugen houden, en via .buffer zijn ook bytes buiten het gekozen bereik toegankelijk. Gebruik slice() voor een onafhankelijke kopie van de gekozen elementen. Een aangepaste constructor[Symbol.species] kan code uitvoeren, het elementtype wijzigen of bepalen of het resultaat opslag deelt. Beschouw deze methoden niet als een beveiligingsgrens voor onbetrouwbare objecten.
In ECMAScript 2024 volgt met de standaardconstructor de lengte van het resultaat van subarray() de buffergrootte als de bronweergave dat ook doet en end is weggelaten of undefined is. Een end anders dan undefined geeft een weergave met vaste lengte; slice() geeft standaard een kopie met vaste lengte. Als de buffer bij aanroep is losgekoppeld of de bronweergave al buiten de buffergrenzen ligt, gooit slice() een TypeError. subarray() rekent dan met een bronlengte van 0, maar het aanmaken van het resultaat kan nog steeds mislukken. Controleer of je doelomgeving buffers met aanpasbare grootte ondersteunt.
Voorbeelden
{
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}`);
}Resultaat
source: 10, 99, 77, 40 view: 99, 77 copy: 20, 30 same buffer: true, false
`(1, -1)` selecteert `20` en `30`. Schrijven via `view` wijzigt `source`, en schrijven via `source` wijzigt `view`. `copy` behoudt `20, 30` en heeft een aparte buffer.
Gerelateerde lessen
- JavaScript · Les 2 · Gevorderd · Versie: 4
Bronnen
- 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