WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

BigUint64Array: vorzeichenlose 64-Bit-Ganzzahlen

BigUint64Array speichert BigInt-Werte als vorzeichenlose 64-Bit-Zahlen und bricht sie modulo 2^64 um.

Version: 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?) erzeugt ein vorzeichenloses Typed Array mit 8 Byte je Element. Quelle kann Länge, Iterable, array-ähnlicher Wert, BigInt64Array/BigUint64Array oder Puffer sein; ein numerisches Typed Array hat einen anderen Inhaltstyp und löst TypeError aus. Die Pufferform ist eine Ansicht ohne Kopie, byteOffset muss durch 8 teilbar sein.

Beim Schreiben wird zu BigInt konvertiert und modulo 2^64 reduziert: -1n wird 2^64 - 1, 2^64 + 5 wird 5n. Ein gewöhnlicher Number löst TypeError aus; BigInt(number) akzeptiert nur einen ganzzahligen Number, ein Bruchwert ergibt RangeError. Die Byteordnung ist plattformnativ; für ein festes Format dient DataView.

Die Länge durchläuft ToIndex: Bruchteile werden gegen null abgeschnitten, NaN/undefined werden 0, auch -0.5 ergibt 0. Negatives Ergebnis nach ToIntegerOrInfinity, Unendlichkeit, Bereichsüberschreitung, falsche Ausrichtung oder ein Bereich außerhalb des Puffers ergibt RangeError. Abgelöster Puffer und inkompatible Werte ergeben TypeError. Das API stammt aus ECMAScript 2020; BYTES_PER_ELEMENT ist 8.

Beispiele

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); }

Ergebnis

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

Quellen