CKTIS / JavaScript
BigUint64Array: 64-bitové celé čísla bez znamienka
BigUint64Array ukladá BigInt ako 64-bitové celé čísla bez znamienka a zalamuje ich modulo 2^64.
Verzia: 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?) vytvorí typed array bez znamienka s 8 bajtmi na prvok. Zdrojom môže byť dĺžka, iterable či array-like, BigInt64Array/BigUint64Array alebo buffer; číselný typed array má iný typ obsahu a vyvolá TypeError. Bufferová forma je pohľad bez kópie a byteOffset musí byť násobkom 8.
Zápis prevedie na BigInt a redukuje modulo 2^64: -1n sa zmení na 2^64 - 1 a 2^64 + 5 na 5n. Bežný Number vyvolá TypeError; BigInt(number) prijíma len celočíselný Number, desatinný vyvolá RangeError. Poradie bajtov je natívne; pre pevný formát použite DataView.
Dĺžka prechádza ToIndex: zlomky sa odrežú k nule, NaN/undefined sa zmenia na 0 a -0.5 tiež dá 0. Záporný výsledok po ToIntegerOrInfinity, nekonečno, prekročenie rozsahu, nezarovnaný posun alebo rozsah mimo buffer vyvolá RangeError. Odpojený buffer a nekompatibilné hodnoty vyvolajú TypeError. API je z ECMAScript 2020; BYTES_PER_ELEMENT je 8.
Príklady
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); }Výsledok
0,18446744073709551615,5 8 8 42n 8 2 0 true true