Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

BigInt64Array: 64-bitni cijeli brojevi s predznakom

BigInt64Array sprema BigInt vrijednosti kao 64-bitne cijele brojeve s predznakom i prelama ih modulo 2^64.

Verzija: ECMAScript 2020 onward; example target: Node.js 24.22.2

Sintaksa

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

new BigInt64Array(source?, byteOffset?, length?) stvara typed array za BigInt s predznakom, po 8 bajtova po elementu. Izvor može biti broj elemenata, iterable ili array-like, drugi typed array s vrstom sadržaja BigInt (BigInt64Array ili BigUint64Array); brojčani typed array ima nekompatibilnu vrstu sadržaja i baca TypeError ili ArrayBuffer/SharedArrayBuffer. Oblik s međuspremnikom stvara pogled bez kopiranja, a byteOffset mora biti višekratnik 8. Novi elementi su nule.

Pri zapisu se vrijednost pretvara u BigInt, reducira modulo 2^64 i tumači u dvojnom komplementu od -2^63 do 2^63-1. Zato 2n ** 63n postaje -2n ** 63n. Obični Number nije dopušten i baca TypeError; za namjernu pretvorbu koristite BigInt(number), ali samo ako je number cijeli broj; razlomljeni Number baca RangeError. Redoslijed bajtova je izvoran platformi, za fiksni format koristite DataView.

Konstruktor zahtijeva new. Duljina prolazi kroz ToIndex: razlomci se odsijecaju prema nuli, NaN i undefined postaju 0, a -0.5 postaje -0 i zato 0. Negativan rezultat nakon ToIntegerOrInfinity, beskonačnost, prekoračenje raspona, neporavnat pomak ili raspon izvan međuspremnika baca RangeError; odvojen međuspremnik ili nepretvorljiva vrijednost baca TypeError. API je iz ECMAScript 2020, a BigInt64Array.BYTES_PER_ELEMENT je 8.

Primjeri

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

Rezultat

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

Izvori