CKTIS / JavaScript
BigInt64Array: 64-bitové celé čísla so znamienkom
BigInt64Array ukladá hodnoty BigInt ako 64-bitové celé čísla so znamienkom a zalamuje ich modulo 2^64.
Verzia: 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?) vytvorí typed array pre BigInt so znamienkom, 8 bajtov na prvok. Zdrojom môže byť počet prvkov, iterable či array-like, iný typed array s obsahom typu BigInt (BigInt64Array alebo BigUint64Array); číselný typed array má nekompatibilný typ obsahu a vyvolá TypeError alebo ArrayBuffer/SharedArrayBuffer. Bufferová forma vytvorí pohľad bez kopírovania a byteOffset musí byť násobkom 8. Nové prvky sú nulové.
Pri zápise sa hodnota prevedie na BigInt, redukuje modulo 2^64 a vyloží v dvojkovom doplnku od -2^63 do 2^63-1. Preto sa 2n ** 63n zmení na -2n ** 63n. Bežný Number nie je povolený a vyvolá TypeError; na zámerný prevod použite BigInt(number), ale len keď je number celé číslo; desatinný Number vyvolá RangeError. Poradie bajtov je natívne, pre pevný formát použite DataView.
Konštruktor vyžaduje new. Dĺžka prechádza ToIndex: zlomky sa odrežú smerom k nule, NaN a undefined sa zmenia na 0 a -0.5 sa zmení na -0, teda 0. Záporný výsledok po ToIntegerOrInfinity, nekonečno, prekročenie rozsahu, nezarovnaný posun alebo rozsah mimo buffer vyvolá RangeError; odpojený buffer či neprevediteľná hodnota vyvolá TypeError. API pochádza z ECMAScript 2020 a BigInt64Array.BYTES_PER_ELEMENT je 8.
Príklady
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); }Výsledok
1,-2,-9223372036854775808 5,-1 8 8 42n 8 true