CKTIS / JavaScript
BigInt64Array: interi con segno a 64 bit
BigInt64Array memorizza valori BigInt come interi con segno a 64 bit e li avvolge modulo 2^64.
Versione: ECMAScript 2020 onward; example target: Node.js 24.22.2
Sintassi
new BigInt64Array(); new BigInt64Array(length); new BigInt64Array(source); new BigInt64Array(buffer[, byteOffset[, length]])new BigInt64Array(source?, byteOffset?, length?) crea un typed array di BigInt con segno, con 8 byte per elemento. La sorgente può essere un numero di elementi, un iterable o array-like, un altro typed array con tipo di contenuto BigInt (BigInt64Array o BigUint64Array); un typed array numerico ha tipo incompatibile e genera TypeError o un ArrayBuffer/SharedArrayBuffer. La forma con buffer crea una vista senza copia e byteOffset deve essere multiplo di 8. I nuovi elementi sono inizializzati a zero.
All’assegnazione il valore è convertito in BigInt, ridotto modulo 2^64 e interpretato in complemento a due da -2^63 a 2^63-1. Quindi 2n ** 63n diventa -2n ** 63n. Un normale Number non è accettato e genera TypeError; usare BigInt(number) per una conversione voluta, ma solo se number è intero; un Number frazionario genera RangeError. Il typed array usa l’ordine di byte nativo; per un formato fisso usare DataView.
Il costruttore richiede new. La lunghezza passa per ToIndex: le frazioni sono troncate verso zero, NaN e undefined diventano 0 e -0.5 diventa -0, quindi 0. Un risultato negativo dopo ToIntegerOrInfinity, infinito, superamento dell’intervallo, offset non allineato o intervallo fuori buffer genera RangeError; buffer scollegato o valore non convertibile genera TypeError. L’API è stata standardizzata in ECMAScript 2020 e BigInt64Array.BYTES_PER_ELEMENT vale 8.
Esempi
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); }Risultato
1,-2,-9223372036854775808 5,-1 8 8 42n 8 true