DataView.prototype.getBigInt64()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.

getBigInt64() メソッドは、符号つき 64 ビット整数 (long long) を DataView の先頭からのバイト単位のオフセット位置から取得します。

試してみましょう

// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(16);

// Highest possible BigInt value that fits in a signed 64-bit integer
const max = 2n ** (64n - 1n) - 1n;

const view = new DataView(buffer);
view.setBigInt64(1, max);

console.log(view.getBigInt64(1));
// Expected output: 9223372036854775807n

構文

js
getBigInt64(byteOffset);
getBigInt64(byteOffset, littleEndian);

引数

byteOffset

データを読み取るビューの先頭からのバイト単位のオフセットです。

littleEndian

省略可 64 ビット整数をリトルエンディアンまたはビッグエンディアンのどちらの形式で格納されているかを示します。 false または undefined の場合、ビッグエンディアンの値が読み取られます。

返値

BigInt です。

発生するエラー

RangeError

byteOffset がビューの末尾を超えて読み取るような値に設定されたときに発生します。

解説

アライメントの制約はありません。複数バイトの値はどのオフセットからでも読み取ることができます。

例

getBigInt64 メソッドの使用

js
var buffer = new ArrayBuffer(8);
var dataview = new DataView(buffer);
dataview.getBigInt64(0); // 0n

仕様書

Specification
ECMAScript® 2025 Language Specification
# sec-dataview.prototype.getbigint64

ブラウザーの互換性

BCD tables only load in the browser

関連情報