DataView.prototype.setBigInt64()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2021年9月.
setBigInt64() は DataView インスタンスのメソッドで、長整数を受け取り、符号付き 64 ビット整数として、この DataView の指定されたバイトオフセットから始まる 8 バイトに格納します。アラインメント制約はなく、マルチバイトの値は範囲内の任意のオフセットに格納できます。
試してみましょう
// 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
setBigInt64(byteOffset, value)
setBigInt64(byteOffset, value, littleEndian)
引数
byteOffset-
データを格納するビューの先頭からのバイト単位のオフセットです。
value-
長整数 (
BigInt) として設定する値。値がどのようにバイト列にエンコードされるかについては、値のエンコード方式と正規化を参照してください。 littleEndian省略可-
データをリトルエンディアンまたはビッグエンディアンのどちらの形式で格納するかを示します。
falseまたはundefinedの場合、ビッグエンディアンの値が書き込まれます。
返値
undefined です。
発生するエラー
RangeError-
byteOffsetがビューの末尾を越えて格納するように設定されたときに発生します。
例
setBigInt64() メソッドの使用
js
const buffer = new ArrayBuffer(10);
const dataview = new DataView(buffer);
dataview.setBigInt64(0, 3n);
dataview.getBigInt64(1); // 768n
仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-dataview.prototype.setbigint64 |