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