CKTIS / JavaScript
BigUint64Array: 64-bitowe liczby całkowite bez znaku
BigUint64Array przechowuje wartości BigInt jako 64-bitowe liczby bez znaku i zawija je modulo 2^64.
Wersja: ECMAScript 2020 onward; example target: Node.js 24.22.2
Składnia
new BigUint64Array(); new BigUint64Array(length); new BigUint64Array(source); new BigUint64Array(buffer[, byteOffset[, length]])new BigUint64Array(source?, byteOffset?, length?) tworzy typed array bez znaku, po 8 bajtów na element. Źródłem może być długość, iterable lub array-like, BigInt64Array/BigUint64Array albo bufor; numeric typed array ma inny typ zawartości i powoduje TypeError. Wariant buforowy jest widokiem bez kopiowania, a byteOffset musi być wielokrotnością 8.
Zapis konwertuje wartość do BigInt i redukuje ją modulo 2^64, więc -1n staje się 2^64 - 1, a 2^64 + 5 staje się 5n. Zwykły Number powoduje TypeError; BigInt(number) przyjmuje tylko całkowity Number, a ułamkowy powoduje RangeError. Kolejność bajtów jest natywna; do ustalonego formatu użyj DataView.
Długość przechodzi ToIndex: ułamki są obcinane ku zeru, NaN/undefined dają 0, a -0.5 także daje 0. Ujemny wynik po ToIntegerOrInfinity, nieskończoność, przekroczenie zakresu, niewyrównane przesunięcie lub zakres poza buforem powoduje RangeError. Odłączony bufor i niezgodne wartości powodują TypeError. API pochodzi z ECMAScript 2020; BYTES_PER_ELEMENT wynosi 8.
Przykłady
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); }Wynik
0,18446744073709551615,5 8 8 42n 8 2 0 true true