JavaScript/BigUint64Array

BigUint64Array

概要

BigUint64Array は、64ビットの符号なし整数（BigInt）の型付き配列を表すJavaScriptオブジェクトです。各要素は BigInt 値としてアクセス可能で、大きな整数を効率的に操作することができます。この配列は、基盤となる ArrayBuffer 上で動作します。

コンストラクタ

BigUint64Array()

new BigUint64Array(buffer [, byteOffset [, length]])
new BigUint64Array(length)
new BigUint64Array(typedArray)
new BigUint64Array(iterable)

• 引数
  • buffer: ArrayBuffer または SharedArrayBuffer
  • byteOffset (オプション): バイト単位でのオフセット位置（デフォルトは 0）
  • length (オプション): 配列の要素数
  • length (数値): 配列の要素数を指定する
  • typedArray: 既存の型付き配列を基にする
  • iterable: 配列や反復可能オブジェクト（Map や Set など）
• 戻り値: 指定された条件に基づく新しい BigUint64Array

プロパティ

BigUint64Array.BYTES_PER_ELEMENT

• 各要素のバイト長（固定値: 8）

BigUint64Array.prototype.length

• 配列内の要素数を返す（読み取り専用）

BigUint64Array.prototype.buffer

• 基盤となる ArrayBuffer を返す

BigUint64Array.prototype.byteOffset

• ArrayBuffer 内の先頭位置をバイト単位で返す

BigUint64Array.prototype.byteLength

• バッファの全体のバイト長を返す

メソッド

BigUint64Array.prototype.set()

bigUint64Array.set(array [, offset])

• 引数
  • array: コピー元の配列（型付き配列または通常の配列）
  • offset (オプション): 書き込みの開始インデックス（デフォルトは 0）
• 戻り値: なし
• 説明: 指定された配列から要素をコピーして設定する

BigUint64Array.prototype.subarray()

bigUint64Array.subarray(begin [, end])

• 引数
  • begin: 開始インデックス
  • end (オプション): 終了インデックス（デフォルトは配列の終端）
• 戻り値: 元の配列の部分範囲を共有する新しい BigUint64Array

使用例

// BigUint64Arrayの作成
const buffer = new ArrayBuffer(16);
const bigUint64Array = new BigUint64Array(buffer);

// 配列の要素を設定
bigUint64Array[0] = 42n;
bigUint64Array[1] = 123456789123456789n;

console.log(bigUint64Array[0]); // 42n
console.log(bigUint64Array[1]); // 123456789123456789n

// 配列のコピー
const subArray = bigUint64Array.subarray(0, 1);
console.log(subArray[0]); // 42n

注意点

• BigUint64Array は BigInt のみを扱い、他の型の値を代入しようとするとエラーになる
• バッファのバイト長は BigUint64Array.BYTES_PER_ELEMENT（8バイト）の倍数である必要がある
• WebAssembly や暗号化処理、ファイル操作など、64ビット精度が求められる場面で使用される

関連オブジェクト

• JavaScript/BigInt64Array
• JavaScript/TypedArray
• JavaScript/ArrayBuffer
• JavaScript/DataView

ブラウザサポート

• Chrome 67+
• Firefox 68+
• Safari 14+
• Edge 79+

仕様

• ECMAScript 2020 (ES11)