KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

BigInt64Array: 64-bits gehele getallen met teken

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

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

Syntax

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

new BigInt64Array(source?, byteOffset?, length?) maakt een typed array voor BigInt met teken, met 8 bytes per element. De bron kan een elementaantal, iterable of array-achtige waarde, andere typed array met BigInt-inhoudstype (BigInt64Array of BigUint64Array); een numerieke typed array heeft een incompatibel inhoudstype en werpt TypeError of ArrayBuffer/SharedArrayBuffer zijn. De buffervorm maakt zonder kopie een view; byteOffset moet een veelvoud van 8 zijn. Nieuwe elementen zijn nul.

Bij toewijzing wordt de waarde naar BigInt geconverteerd, modulo 2^64 gereduceerd en in het two’s-complementbereik -2^63 tot 2^63-1 geïnterpreteerd. Zo wordt 2n ** 63n -2n ** 63n. Een gewone Number is niet toegestaan en werpt TypeError; gebruik BigInt(number) voor bewuste conversie, maar alleen als number geheel is; een fractionele Number werpt RangeError. De bytevolgorde is platformeigen; gebruik DataView voor een vast formaat.

De constructor vereist new. De lengte doorloopt ToIndex: breuken worden naar nul afgekapt, NaN en undefined worden 0, en -0.5 wordt -0 en dus 0. Een negatief resultaat na ToIntegerOrInfinity, oneindigheid, bereikoverschrijding, verkeerd uitgelijnde offset of bereik buiten de buffer werpt RangeError; een losgekoppelde buffer of niet-converteerbare waarde werpt TypeError. De API is in ECMAScript 2020 gestandaardiseerd en BigInt64Array.BYTES_PER_ELEMENT is 8.

Voorbeelden

const signed = new BigInt64Array([1n, -2n, 2n ** 63n]);
console.log(Array.from(signed, String).join(","));

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

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

try { signed[0] = 1; } catch (error) { console.log(error instanceof TypeError); }

Resultaat

1,-2,-9223372036854775808
5,-1
8 8 42n 8
true

Bronnen