CKTIS / JavaScript
BigInt64Array: vorzeichenbehaftete 64-Bit-Ganzzahlen
BigInt64Array speichert BigInt-Werte als vorzeichenbehaftete 64-Bit-Zahlen und bricht sie modulo 2^64 um.
Version: 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?) erzeugt ein Typed Array für vorzeichenbehaftete BigInt-Elemente mit je 8 Byte. Quelle kann Elementzahl, Iterable, array-ähnlicher Wert, anderes Typed Array mit BigInt-Inhaltstyp (BigInt64Array oder BigUint64Array); ein numerisches Typed Array hat einen inkompatiblen Inhaltstyp und löst TypeError aus oder ArrayBuffer/SharedArrayBuffer sein. Die Pufferform erstellt ohne Kopie eine Ansicht; byteOffset muss durch 8 teilbar sein. Neue Elemente sind nullgefüllt.
Beim Schreiben wird der Wert zu BigInt konvertiert, modulo 2^64 reduziert und im Zweierkomplementbereich -2^63 bis 2^63-1 interpretiert. Somit wird 2n ** 63n zu -2n ** 63n. Ein gewöhnlicher Number ist unzulässig und ergibt TypeError; für bewusste Konvertierung dient BigInt(number), jedoch nur bei ganzzahligem number; ein Bruchwert löst RangeError aus. Typed Arrays nutzen die native Byteordnung, für festes Binärformat dient DataView.
Der Konstruktor verlangt new. Die Länge durchläuft ToIndex: Bruchteile werden gegen null abgeschnitten, NaN und undefined werden 0, und -0.5 wird zu -0 und damit ebenfalls 0. Ein negatives Ergebnis nach ToIntegerOrInfinity, Unendlichkeit, Bereichsüberschreitung, falsch ausgerichteter Versatz oder ein Bereich außerhalb des Puffers ergibt RangeError; abgelöster Puffer oder nicht konvertierbarer Wert ergeben TypeError. Das API stammt aus ECMAScript 2020; BigInt64Array.BYTES_PER_ELEMENT ist 8.
Beispiele
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); }Ergebnis
1,-2,-9223372036854775808 5,-1 8 8 42n 8 true