Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

BigInt64Array: predznačena 64-bitna cela števila

BigInt64Array shranjuje vrednosti BigInt kot predznačena 64-bitna cela števila in jih ovije modulo 2^64.

Različica: 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?) ustvari typed array za predznačeni BigInt, po 8 bajtov na element. Vir je lahko število elementov, iterable ali array-like, drug typed array z vsebinskim tipom BigInt (BigInt64Array ali BigUint64Array); številski typed array ima nezdružljiv vsebinski tip in sproži TypeError ali ArrayBuffer/SharedArrayBuffer. Oblika z medpomnilnikom ustvari pogled brez kopiranja, byteOffset pa mora biti večkratnik 8. Novi elementi so ničle.

Pri zapisu se vrednost pretvori v BigInt, reducira modulo 2^64 in razlaga v dvojiškem komplementu od -2^63 do 2^63-1. Zato 2n ** 63n postane -2n ** 63n. Navaden Number ni dovoljen in sproži TypeError; za namerno pretvorbo uporabite BigInt(number), vendar le, če je number celo število; ulomljeni Number sproži RangeError. Vrstni red bajtov je izvoren, za fiksen format uporabite DataView.

Konstruktor zahteva new. Dolžina gre skozi ToIndex: ulomki se odrežejo proti ničli, NaN in undefined postaneta 0, -0.5 pa postane -0 in zato 0. Negativen rezultat po ToIntegerOrInfinity, neskončnost, prekoračitev obsega, neporavnan odmik ali obseg zunaj medpomnilnika sproži RangeError; odklopljen medpomnilnik ali nepretvorljiva vrednost sproži TypeError. API je iz ECMAScript 2020 in BigInt64Array.BYTES_PER_ELEMENT je 8.

Primeri

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

Viri