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

CKTIS / JavaScript

BigUint64Array: inteiros sem sinal de 64 bits

BigUint64Array guarda BigInt como inteiros sem 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 BigUint64Array(); new BigUint64Array(length); new BigUint64Array(source); new BigUint64Array(buffer[, byteOffset[, length]])

new BigUint64Array(source?, byteOffset?, length?) cria um typed array sem sinal de 8 bytes por elemento. A origem pode ser comprimento, iterable ou array-like, BigInt64Array/BigUint64Array ou buffer; um typed array numérico tem outro tipo de conteúdo e lança TypeError. A forma com buffer é uma vista sem cópia e byteOffset tem de ser múltiplo de 8.

A atribuição converte para BigInt e reduz módulo 2^64: -1n torna-se 2^64 - 1 e 2^64 + 5 torna-se 5n. Um Number normal lança TypeError; BigInt(number) só aceita Number inteiro, enquanto um fracionário lança RangeError. A ordem dos bytes é nativa; use DataView para formato fixo.

O comprimento passa por ToIndex: frações são truncadas para zero, NaN/undefined tornam-se 0 e -0.5 também dá 0. Resultado negativo após ToIntegerOrInfinity, infinito, excesso de intervalo, deslocamento desalinhado ou intervalo fora do buffer lança RangeError. Buffer separado e valores incompatíveis lançam TypeError. A API é do ECMAScript 2020; BYTES_PER_ELEMENT é 8.

Exemplos

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

Resultado

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

Fontes