KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Uint16Array — getypeerde array voor 16-bits gehele getallen zonder teken

Uint16Array is een getypeerde bufferweergave die gehele getallen van 0 tot en met 65535 opslaat, met 2 bytes per element. Ontdek hoe waarden worden omgezet en wat het verschil is tussen gegevens kopiëren en een weergave delen.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

new Uint16Array(length)
new Uint16Array(iterableOrArrayLike)
new Uint16Array(typedArray)
new Uint16Array(buffer, byteOffset?, length?)

Uint16Array is een ingebouwde getypeerde array van ECMAScript, geen gewone Array. Elk element neemt 2 bytes in en wordt bij uitlezen teruggegeven als een Number van 0 tot en met 65535. length geeft het aantal elementen aan, byteLength het aantal bytes van de weergave en Uint16Array.BYTES_PER_ELEMENT is 2.

De constructor vereist new. Bij een numeriek argument bepaalt de constructor met ToIndex hoeveel elementen op nul worden gezet. Zo maakt new Uint16Array(3.9) drie elementen aan, terwijl new Uint16Array(-1) een RangeError geeft. Een collectie levert waarden om te kopiëren. De variant met ArrayBuffer maakt een weergave zonder te kopiëren: byteOffset wordt in bytes uitgedrukt en moet een veelvoud van 2 zijn. De optionele length telt elementen, geen bytes.

Bij het schrijven worden waarden omgezet in plaats van op hun bereik gecontroleerd: eindige Number-waarden worden naar nul afgekapt en daarna modulo 65536 gereduceerd. Daardoor wordt 65536 omgezet in 0, -1 in 65535 en 3.9 in 3. NaN en oneindigheden worden 0; BigInt-waarden veroorzaken een TypeError. Dit is geen begrenzing tot het bereik.

subarray() deelt de opslag met het origineel, terwijl slice() gegevens kopieert. Het voorbeeld laat de omzetting zien en hoe de weergave het origineel wijzigt. De bytevolgorde is eigen aan de implementatie; gebruik DataView voor een binair formaat met een expliciete bytevolgorde.

Voorbeelden

const values = new Uint16Array([65535, 65536, -1, 3.9]);
const view = values.subarray(1, 3);
view[0] = 42;
console.log(values.join(","));
console.log(`${values.length} ${values.byteLength} ${Uint16Array.BYTES_PER_ELEMENT}`);

Resultaat

65535,42,65535,3
4 8 2

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen