CKTIS / JavaScript
BigInt64Array: 64-bitowe liczby całkowite ze znakiem
BigInt64Array przechowuje wartości BigInt jako 64-bitowe liczby ze znakiem, zawijając je modulo 2^64.
Wersja: ECMAScript 2020 onward; example target: Node.js 24.22.2
Składnia
new BigInt64Array(); new BigInt64Array(length); new BigInt64Array(source); new BigInt64Array(buffer[, byteOffset[, length]])new BigInt64Array(source?, byteOffset?, length?) tworzy typed array o elementach BigInt ze znakiem, po 8 bajtów każdy. Źródłem może być liczba elementów, iterable lub array-like, inny typed array o typie zawartości BigInt (BigInt64Array albo BigUint64Array); numeric typed array ma niezgodny typ zawartości i powoduje TypeError albo ArrayBuffer/SharedArrayBuffer. Wariant buforowy tworzy widok bez kopiowania; byteOffset musi być wielokrotnością 8. Nowe elementy są zerowane.
Przy zapisie wartość jest konwertowana do BigInt, redukowana modulo 2^64 i interpretowana w kodzie uzupełnień do dwóch z zakresu -2^63…2^63-1. Dlatego 2n ** 63n staje się -2n ** 63n. Zwykły Number nie jest akceptowany i powoduje TypeError; do jawnej konwersji użyj BigInt(number), ale tylko gdy number jest całkowity; wartość ułamkowa powoduje RangeError. Kolejność bajtów typed array jest natywna dla platformy, więc do ustalonego formatu binarnego użyj DataView.
Konstruktor wymaga new. Długość przechodzi ToIndex: ułamki są obcinane w stronę zera, NaN i undefined dają 0, a -0.5 staje się -0, więc także daje 0. Ujemny wynik po ToIntegerOrInfinity, nieskończoność, przekroczenie zakresu, niewyrównane przesunięcie albo zakres wychodzący poza bufor powoduje RangeError; odłączony bufor i niekonwertowalne wartości powodują TypeError. API jest dostępne od ECMAScript 2020, a BigInt64Array.BYTES_PER_ELEMENT ma wartość 8.
Przykłady
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); }Wynik
1,-2,-9223372036854775808 5,-1 8 8 42n 8 true