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