Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

BigUint64Array: 64-bitni cijeli brojevi bez predznaka

BigUint64Array sprema BigInt kao 64-bitne cijele brojeve bez predznaka i prelama ih modulo 2^64.

Verzija: 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?) stvara typed array bez predznaka s 8 bajtova po elementu. Izvor može biti duljina, iterable ili array-like, BigInt64Array/BigUint64Array ili međuspremnik; brojčani typed array ima drugu vrstu sadržaja i baca TypeError. Oblik s međuspremnikom je pogled bez kopije, a byteOffset mora biti višekratnik 8.

Zapis pretvara u BigInt i reducira modulo 2^64: -1n postaje 2^64 - 1, a 2^64 + 5 postaje 5n. Obični Number baca TypeError; BigInt(number) prihvaća samo cijeli Number, a razlomljeni baca RangeError. Redoslijed bajtova je izvoran; za fiksni format koristite DataView.

Duljina prolazi kroz ToIndex: razlomci se odsijecaju prema nuli, NaN/undefined postaju 0 i -0.5 također daje 0. Negativan rezultat nakon ToIntegerOrInfinity, beskonačnost, prekoračenje raspona, neporavnat pomak ili raspon izvan međuspremnika baca RangeError. Odvojen međuspremnik i nekompatibilne vrijednosti bacaju TypeError. API je iz ECMAScript 2020; BYTES_PER_ELEMENT je 8.

Primjeri

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

Izvori