KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

BigUint64Array: 64-bits gehele getallen zonder teken

BigUint64Array bewaart BigInt-waarden als 64-bits getallen zonder teken en laat ze modulo 2^64 omlopen.

Versie: ECMAScript 2020 onward; example target: Node.js 24.22.2

Syntax

new BigUint64Array(); new BigUint64Array(length); new BigUint64Array(source); new BigUint64Array(buffer[, byteOffset[, length]])

new BigUint64Array(source?, byteOffset?, length?) maakt een typed array zonder teken met 8 bytes per element. De bron kan lengte, iterable of array-achtig, BigInt64Array/BigUint64Array of buffer zijn; een numerieke typed array heeft een ander inhoudstype en werpt TypeError. De buffervorm is een view zonder kopie en byteOffset moet een veelvoud van 8 zijn.

Toewijzing converteert naar BigInt en reduceert modulo 2^64: -1n wordt 2^64 - 1 en 2^64 + 5 wordt 5n. Een gewone Number werpt TypeError; BigInt(number) accepteert alleen een gehele Number, een breuk werpt RangeError. Bytevolgorde is platformeigen; gebruik DataView voor een vast formaat.

De lengte doorloopt ToIndex: breuken worden naar nul afgekapt, NaN/undefined worden 0 en -0.5 geeft ook 0. Negatief resultaat na ToIntegerOrInfinity, oneindigheid, te groot bereik, verkeerd uitgelijnde offset of bereik buiten de buffer werpt RangeError. Losgekoppelde buffer en incompatibele waarden werpen TypeError. De API is van ECMAScript 2020; BYTES_PER_ELEMENT is 8.

Voorbeelden

const values = new BigUint64Array([0n, -1n, 2n ** 64n + 5n]);
console.log(Array.from(values, String).join(","));

const buffer = new ArrayBuffer(16);
const view = new BigUint64Array(buffer, 8, 1);
view[0] = 42n;
console.log(view.byteOffset, view.byteLength, view[0], BigUint64Array.BYTES_PER_ELEMENT);

console.log(new BigUint64Array(2.9).length, new BigUint64Array(-0.5).length);
try { values[0] = 1; } catch (error) { console.log(error instanceof TypeError); }
try { new BigUint64Array(new Uint8Array([1])); } catch (error) { console.log(error instanceof TypeError); }

Resultaat

0,18446744073709551615,5
8 8 42n 8
2 0
true
true

Bronnen