DataView.prototype.getBigInt64()
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2021年9月以降、すべてのブラウザーで利用可能です。
getBigInt64() は DataView インスタンスのメソッドで、この DataView の指定されたバイトオフセットから 8 バイトを読み取り、符号付き 64 ビット整数として解釈します。アラインメント制約はありません。境界内の任意のオフセットからマルチバイト値を取得できます。
試してみましょう
// ArrayBuffer をバイト単位のサイズで作成
const buffer = new ArrayBuffer(16);
// 符号付き 64 ビット整数に収まる最大の長整数値
const max = 2n ** (64n - 1n) - 1n;
const view = new DataView(buffer);
view.setBigInt64(1, max);
console.log(view.getBigInt64(1));
// 予想される結果: 9223372036854775807n
構文
js
getBigInt64(byteOffset)
getBigInt64(byteOffset, littleEndian)
引数
byteOffset-
ビューの先頭からのバイト単位のオフセットで、データを読み取る位置です。
littleEndian省略可-
データがリトルエンディアンとビッグエンディアンのどちらの形式で格納されているかを示します。
falseまたはundefinedの場合、ビッグエンディアンの値が読み取られます。
返値
長整数 (BigInt) で、-263 以上 263-1 以下です。
例外
RangeError-
byteOffsetがビューの末尾を越えて読み取るように設定されている場合に発生します。
例
getBigInt64() の使用
js
const { buffer } = new Uint8Array([0, 1, 2, 3, 4, 5, 6, 7, 8, 9]);
const dataview = new DataView(buffer);
console.log(dataview.getBigInt64(1)); // 72623859790382856n
仕様書
| 仕様書 |
|---|
| ECMAScript® 2027 Language Specification # sec-dataview.prototype.getbigint64 |