Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

BigUint64Array: interi senza segno a 64 bit

BigUint64Array memorizza BigInt come interi senza segno a 64 bit e li avvolge modulo 2^64.

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

Sintassi

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

new BigUint64Array(source?, byteOffset?, length?) crea un typed array senza segno di 8 byte per elemento. La sorgente può essere una lunghezza, iterable o array-like, BigInt64Array/BigUint64Array o buffer; un typed array numerico ha un altro tipo di contenuto e genera TypeError. La forma con buffer è una vista senza copia e byteOffset deve essere multiplo di 8.

L’assegnazione converte in BigInt e riduce modulo 2^64: -1n diventa 2^64 - 1 e 2^64 + 5 diventa 5n. Un Number normale genera TypeError; BigInt(number) accetta solo un Number intero, mentre una frazione genera RangeError. L’ordine dei byte è nativo; usare DataView per un formato fisso.

La lunghezza passa per ToIndex: le frazioni sono troncate verso zero, NaN/undefined diventano 0 e -0.5 dà anch’esso 0. Risultato negativo dopo ToIntegerOrInfinity, infinito, intervallo eccessivo, offset non allineato o intervallo fuori buffer genera RangeError. Buffer scollegato e valori incompatibili generano TypeError. L’API è di ECMAScript 2020; BYTES_PER_ELEMENT vale 8.

Esempi

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

Risultato

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

Fonti