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() メソッドは、符号つき 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
setBigInt64(byteOffset, value);
setBigInt64(byteOffset, value, littleEndian);
引数
- byteOffset
-
データを格納するビューの先頭からのバイト単位のオフセットです。
- value
-
BigIntとして設定する値です。符号つき 64 ビット整数に符合する最も大きな値は、2n ** (64n -1n) - 1n(9223372036854775807n) です。これを上回ると、負の数 (-9223372036854775808n) になります。 - littleEndian
-
省略可 64 ビット整数をリトルエンディアンまたはビッグエンディアンのどちらの形式で格納するかを示します。
falseまたはundefinedの場合、ビッグエンディアンの値が書き込まれます。
返値
undefined です。
発生するエラー
RangeError-
byteOffsetがビューの末尾を超えて格納するような値に設定されたときに発生します。
例
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 |
ブラウザーの互換性
Loading…