Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

BigInt64Array: inteiros com sinal de 64 bits

BigInt64Array guarda valores BigInt como inteiros com sinal de 64 bits e ajusta-os módulo 2^64.

Versão: ECMAScript 2020 onward; example target: Node.js 24.22.2

Sintaxe

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

new BigInt64Array(source?, byteOffset?, length?) cria um typed array de BigInt com sinal, com 8 bytes por elemento. A origem pode ser uma quantidade, iterable ou array-like, outro typed array com tipo de conteúdo BigInt (BigInt64Array ou BigUint64Array); um typed array numérico tem tipo incompatível e lança TypeError ou ArrayBuffer/SharedArrayBuffer. A forma com buffer cria uma vista sem cópia e byteOffset tem de ser múltiplo de 8. Novos elementos são preenchidos com zero.

Na atribuição, o valor é convertido em BigInt, reduzido módulo 2^64 e interpretado em complemento de dois entre -2^63 e 2^63-1. Assim, 2n ** 63n torna-se -2n ** 63n. Um Number normal não é aceite e lança TypeError; use BigInt(number) para conversão intencional, mas apenas se number for inteiro; um Number fracionário lança RangeError. O typed array usa a ordem de bytes nativa; para um formato fixo use DataView.

O construtor exige new. O comprimento passa por ToIndex: frações são truncadas em direção a zero, NaN e undefined tornam-se 0 e -0.5 torna-se -0, portanto 0. Um resultado negativo após ToIntegerOrInfinity, infinito, excesso de intervalo, deslocamento desalinhado ou intervalo fora do buffer lança RangeError; buffer separado ou valor não convertível lança TypeError. A API foi normalizada no ECMAScript 2020 e BigInt64Array.BYTES_PER_ELEMENT é 8.

Exemplos

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

Resultado

1,-2,-9223372036854775808
5,-1
8 8 42n 8
true

Fontes