CKTIS / JavaScript
BigUint64Array: 64-битови цели числа без знак
BigUint64Array съхранява BigInt като 64-битови цели числа без знак и ги обвива по модул 2^64.
Версия: ECMAScript 2020 onward; example target: Node.js 24.22.2
Синтаксис
new BigUint64Array(); new BigUint64Array(length); new BigUint64Array(source); new BigUint64Array(buffer[, byteOffset[, length]])new BigUint64Array(source?, byteOffset?, length?) създава typed array без знак с 8 байта на елемент. Източникът може да е дължина, iterable или array-like, BigInt64Array/BigUint64Array или буфер; числов typed array има друг тип съдържание и хвърля TypeError. Буферната форма е изглед без копиране, а byteOffset трябва да е кратно на 8.
Записът преобразува до BigInt и редуцира по модул 2^64: -1n става 2^64 - 1, а 2^64 + 5 става 5n. Обикновен Number хвърля TypeError; BigInt(number) приема само цяло Number, а дробно хвърля RangeError. Редът на байтовете е нативен; за фиксиран формат използвайте DataView.
Дължината преминава през ToIndex: дробите се отрязват към нула, NaN/undefined стават 0 и -0.5 също дава 0. Отрицателен резултат след ToIntegerOrInfinity, безкрайност, надхвърляне на диапазона, неподравнено отместване или диапазон извън буфера хвърля RangeError. Отделен буфер и несъвместими стойности хвърлят TypeError. API е от ECMAScript 2020; BYTES_PER_ELEMENT е 8.
Примери
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); }Резултат
0,18446744073709551615,5 8 8 42n 8 2 0 true true