База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

BigInt64Array: 64-битови цели числа със знак

BigInt64Array съхранява BigInt стойности като 64-битови цели числа със знак и ги обвива по модул 2^64.

Версия: ECMAScript 2020 onward; example target: Node.js 24.22.2

Синтаксис

new BigInt64Array(); new BigInt64Array(length); new BigInt64Array(source); new BigInt64Array(buffer[, byteOffset[, length]])

new BigInt64Array(source?, byteOffset?, length?) създава typed array за BigInt със знак, по 8 байта на елемент. Източникът може да е брой елементи, iterable или array-like, друг typed array с тип съдържание BigInt (BigInt64Array или BigUint64Array); числов typed array има несъвместим тип съдържание и хвърля TypeError или ArrayBuffer/SharedArrayBuffer. Буферната форма създава изглед без копиране и byteOffset трябва да е кратно на 8. Новите елементи са нули.

При запис стойността се преобразува до BigInt, редуцира се по модул 2^64 и се тълкува в допълнителен код от -2^63 до 2^63-1. Затова 2n ** 63n става -2n ** 63n. Обикновен Number не се приема и хвърля TypeError; за умишлено преобразуване използвайте BigInt(number), но само ако number е цяло число; дробен Number хвърля RangeError. Редът на байтовете е нативен, за фиксиран формат използвайте DataView.

Конструкторът изисква new. Дължината преминава през ToIndex: дробите се отрязват към нула, NaN и undefined стават 0, а -0.5 става -0 и затова 0. Отрицателен резултат след ToIntegerOrInfinity, безкрайност, надхвърляне на диапазона, неподравнено отместване или диапазон извън буфера хвърля RangeError; отделен буфер или непреобразуема стойност хвърля TypeError. API е от ECMAScript 2020 и BigInt64Array.BYTES_PER_ELEMENT е 8.

Примери

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); }

Резултат

1,-2,-9223372036854775808
5,-1
8 8 42n 8
true

Източници