KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Uint32Array — array van 32-bits gehele getallen zonder teken

Uint32Array is een getypeerde bufferweergave: elk element neemt 4 bytes in en slaat een getal van 0 tot en met 4294967295 op. Lees meer over waardeconversie, het maken van weergaven en het verschil tussen gedeeld geheugen en kopiëren.

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 Uint32Array(length)
new Uint32Array(iterableOrArrayLike)
new Uint32Array(typedArray)
new Uint32Array(buffer[, byteOffset[, length]])

Uint32Array is een getypeerde array: een geheugenweergave waarvan de elementen worden gelezen als Number-waarden van 0 tot en met 4294967295. Elk element neemt 4 bytes in; length telt elementen en byteLength telt bytes. Het is geen gewone Array en heeft geen methode push().

new Uint32Array(length) maakt een buffer die met nullen is gevuld. Als je een itereerbaar object of een andere getypeerde array met elementen van het type Number meegeeft, worden de waarden gekopieerd. De constructor geeft een TypeError als de bron een BigInt64Array of BigUint64Array is, ook als die array leeg is. Als je een ArrayBuffer meegeeft, deelt de array het geheugen van die buffer. byteOffset moet een veelvoud van 4 zijn; een expliciete length telt elementen, geen bytes.

Bij het schrijven wordt de conversie ToUint32 toegepast: de waarde wordt naar nul afgekapt en daarna wordt het resultaat modulo 2 ** 32 genomen. Daardoor wordt -1 4294967295 en wordt 2 ** 32 + 7 7. NaN en oneindigheden worden 0; het schrijven van een BigInt veroorzaakt een TypeError. Dit is een conversie, geen bereikcontrole.

subarray() deelt het geheugen, terwijl slice() de elementen kopieert. De bytevolgorde is afhankelijk van de implementatie; gebruik DataView voor binaire formaten die een expliciete bytevolgorde vereisen. In het voorbeeld verandert het aanpassen van view[0] ook values[1].

Voorbeelden

const values = new Uint32Array([1, -1, 2 ** 32 + 7, 3.9]);
const view = values.subarray(1, 3);
view[0] = 42;
console.log(values.join(","));
console.log(values.length, values.byteLength, Uint32Array.BYTES_PER_ELEMENT);

Resultaat

1,42,7,3
4 16 4

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