CKTIS / JavaScript
BigInt64Array: 64bitová celá čísla se znaménkem
BigInt64Array ukládá hodnoty BigInt jako 64bitová celá čísla se znaménkem a zalamuje je modulo 2^64.
Verze: ECMAScript 2020 onward; example target: Node.js 24.22.2
Syntaxe
new BigInt64Array(); new BigInt64Array(length); new BigInt64Array(source); new BigInt64Array(buffer[, byteOffset[, length]])new BigInt64Array(source?, byteOffset?, length?) vytvoří typed array pro BigInt se znaménkem, 8 bajtů na prvek. Zdrojem může být počet prvků, iterable či array-like, jiný typed array s obsahem typu BigInt (BigInt64Array nebo BigUint64Array); číselný typed array má nekompatibilní typ obsahu a vyvolá TypeError nebo ArrayBuffer/SharedArrayBuffer. Bufferová forma vytvoří pohled bez kopírování a byteOffset musí být násobkem 8. Nové prvky jsou nulové.
Při zápisu se hodnota převede na BigInt, redukuje modulo 2^64 a vyloží v dvojkovém doplňku od -2^63 do 2^63-1. Proto se 2n ** 63n změní na -2n ** 63n. Běžný Number není povolen a vyvolá TypeError; pro záměrný převod použijte BigInt(number), ale jen když je number celé číslo; desetinný Number vyvolá RangeError. Pořadí bajtů je nativní, pro pevný formát použijte DataView.
Konstruktor vyžaduje new. Délka prochází ToIndex: zlomky se oříznou směrem k nule, NaN a undefined se změní na 0 a -0.5 se změní na -0, tedy 0. Záporný výsledek po ToIntegerOrInfinity, nekonečno, překročení rozsahu, nezarovnaný posun nebo rozsah mimo buffer vyvolá RangeError; odpojený buffer či nepřevoditelná hodnota vyvolá TypeError. API pochází z ECMAScript 2020 a BigInt64Array.BYTES_PER_ELEMENT je 8.
Pří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ýsledek
1,-2,-9223372036854775808 5,-1 8 8 42n 8 true