CKTIS / JavaScript
TypedArray: buffer, byte-offset, bytelengte en aantal elementen
Maak onderscheid tussen de hele buffer, het bytebereik van de weergave en het aantal elementen. Lees wat de getters teruggeven na een wijziging van de buffergrootte of na loskoppeling.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
view.buffer
view.byteOffset
view.byteLength
view.length
new Uint16Array(buffer)
new Uint16Array(buffer, byteOffset)
new Uint16Array(buffer, byteOffset, length)Een instantie zoals Uint16Array is een weergave van een buffer. TypedArray is de naam van de typefamilie; er is geen globale constructor met die naam die je rechtstreeks kunt aanroepen. De vier eigenschappen zijn overgeërfde getters zonder setter. Roep je zo’n getter aan op een object dat geen getypeerde array is, dan krijg je TypeError. view.length is niet Uint16Array.length, het aantal gedeclareerde parameters van de constructor.
view.buffer geeft hetzelfde onderliggende ArrayBuffer- of SharedArrayBuffer-object terug, geen kopie. view.byteOffset geeft het begin van de weergave aan ten opzichte van het begin van de buffer; view.byteLength geeft de grootte van de weergave aan, beide in bytes. view.length telt elementen. Als beide leesbewerkingen uitgaan van dezelfde weergavegrootte, geldt view.byteLength === view.length * view.BYTES_PER_ELEMENT. De getters worden afzonderlijk aangeroepen: vergroot een andere agent de onderliggende SharedArrayBuffer tussen de twee leesbewerkingen, dan kunnen de getters bij een weergave met dynamische lengte verschillende groottes waarnemen en kan de vergelijking false opleveren. view.buffer.byteLength meet de hele buffer, niet alleen de weergave.
In new Uint16Array(buffer, byteOffset, length) staat het tweede argument voor bytes en het derde voor elementen. Een offset die niet op de elementgrootte is uitgelijnd of een bereik buiten de buffer leidt tot RangeError. Schrijfbewerkingen zijn zichtbaar in overlappende weergaven van dezelfde buffer. Een weergave doorgeven verbergt de overige bytes niet: kopieer de bytes van een geldig bereik naar een aparte buffer om alleen dat bereik te delen.
Bij een buffer met een vaste grootte beslaat de weergave zonder length het restant, waarin een geheel aantal elementen moet passen. Bij een ArrayBuffer met een aanpasbare grootte of een uitbreidbare SharedArrayBuffer maakt weglaten van length of doorgeven van undefined de lengte dynamisch: de weergave telt de hele elementen die vanaf de offset passen. Een expliciet aantal elementen legt de lengte vast.
Door de buffer te verkleinen kan de weergave buiten de grenzen vallen; opnieuw vergroten kan haar weer binnen de grenzen brengen. Als de weergave buiten de grenzen valt of de ArrayBuffer is losgekoppeld (bijvoorbeeld door overdracht), geven alle drie numerieke getters 0 terug, maar buffer geeft nog steeds hetzelfde object terug. Een geldige lege weergave kan een offset groter dan nul hebben. Aanpassen en uitbreiden zijn gespecificeerd in ECMAScript 2024; controleer de ondersteuning in de beoogde uitvoeromgeving.
Voorbeelden
{
const buffer = new ArrayBuffer(16);
const view = new Uint16Array(buffer, 4, 3);
console.log([
view.buffer === buffer,
view.byteOffset,
view.byteLength,
view.length,
view.buffer.byteLength,
].join(" "));
view[0] = 513;
console.log(String(new Uint16Array(buffer)[2]));
}Resultaat
true 4 6 3 16 513
De weergave begint bij byte 4 en omvat drie elementen van twee bytes, dus 6 van de 16 bytes. Schrijven op index 0 is zichtbaar op index 2 in de weergave van de hele buffer.
Gerelateerde lessen
- JavaScript · Les 2 · Gevorderd · Versie: 4