WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen