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

CKTIS / JavaScript

BigUint64Array: nepredznačena 64-bitna cela števila

BigUint64Array shranjuje BigInt kot nepredznač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 BigUint64Array(); new BigUint64Array(length); new BigUint64Array(source); new BigUint64Array(buffer[, byteOffset[, length]])

new BigUint64Array(source?, byteOffset?, length?) ustvari nepredznačeni typed array z 8 bajti na element. Vir je lahko dolžina, iterable ali array-like, BigInt64Array/BigUint64Array ali medpomnilnik; številski typed array ima drug vsebinski tip in sproži TypeError. Oblika z medpomnilnikom je pogled brez kopije, byteOffset mora biti večkratnik 8.

Zapis pretvori v BigInt in reducira modulo 2^64: -1n postane 2^64 - 1, 2^64 + 5 pa 5n. Navaden Number sproži TypeError; BigInt(number) sprejme le celoštevilski Number, ulomljeni sproži RangeError. Vrstni red bajtov je izvoren; za fiksen format uporabite DataView.

Dolžina gre skozi ToIndex: ulomki se odrežejo proti ničli, NaN/undefined postaneta 0 in -0.5 prav tako da 0. Negativen rezultat po ToIntegerOrInfinity, neskončnost, prekoračitev obsega, neporavnan odmik ali obseg zunaj medpomnilnika sproži RangeError. Odklopljen medpomnilnik in nezdružljive vrednosti sprožijo TypeError. API je iz ECMAScript 2020; BYTES_PER_ELEMENT je 8.

Primeri

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

Rezultat

0,18446744073709551615,5
8 8 42n 8
2 0
true
true

Viri