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 September 2021.

setBigInt64() メソッドは、符号つき 64 ビット整数 (long long) を DataView の先頭からのバイト単位の指定されたオフセット位置に格納します。

試してみましょう

構文

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 Language Specification
# sec-dataview.prototype.setbigint64

ブラウザーの互換性

BCD tables only load in the browser

関連情報