DataView.prototype.setBigInt64()
BaselineWidely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.
setBigInt64() メソッドは、符号つき 64 ビット整数 (long long) をDataView の先頭からのバイト単位の指定されたオフセット位置に格納します。
試してみましょう
// Create an ArrayBuffer with a size in bytesconst buffer = new ArrayBuffer(16);// Highest possible BigInt value that fits in a signed 64-bit integerconst max = 2n ** (64n - 1n) - 1n;const view = new DataView(buffer);view.setBigInt64(1, max);console.log(view.getBigInt64(1));// Expected output: 9223372036854775807n構文
js
setBigInt64(byteOffset, value);setBigInt64(byteOffset, value, littleEndian);引数
- byteOffset
データを格納するビューの先頭からのバイト単位のオフセットです。
- value
BigIntとして設定する値です。符号つき 64 ビット整数に符合する最も大きな値は、2n ** (64n -1n) - 1n(9223372036854775807n) です。これを上回ると、負の数 (-9223372036854775808n) になります。- littleEndian
省略可 64 ビット整数をリトルエンディアンまたはビッグエンディアンのどちらの形式で格納するかを示します。
falseまたはundefinedの場合、ビッグエンディアンの値が書き込まれます。
返値
undefined です。
発生するエラー
RangeErrorbyteOffsetがビューの末尾を超えて格納するような値に設定されたときに発生します。
例
setBigInt64 メソッドの使用
js
var buffer = new ArrayBuffer(8);var dataview = new DataView(buffer);dataview.setBigInt64(0, 3n);dataview.getBigInt64(0); // 3n仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-dataview.prototype.setbigint64 |