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.
Phương thức setBigInt64() của các instance DataView nhận một BigInt và lưu trữ nó như một số nguyên có dấu 64-bit trong 8 byte bắt đầu tại độ lệch byte được chỉ định của DataView này. Không có ràng buộc căn chỉnh; các giá trị nhiều byte có thể được lưu trữ tại bất kỳ độ lệch nào trong giới hạn.
Try it
// 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
Cú pháp
setBigInt64(byteOffset, value)
setBigInt64(byteOffset, value, littleEndian)
Tham số
byteOffset-
Độ lệch, tính bằng byte, từ đầu view để lưu trữ dữ liệu vào.
value-
Giá trị cần đặt dưới dạng
BigInt. Để biết cách giá trị được mã hóa trong byte, xem Mã hóa và chuẩn hóa giá trị. littleEndianOptional-
Chỉ ra liệu dữ liệu có được lưu trữ ở định dạng little- hay big-endian. Nếu
falsehoặcundefined, một giá trị big-endian được ghi.
Giá trị trả về
Ngoại lệ
RangeError-
Được ném ra nếu
byteOffsetđược đặt sao cho nó sẽ lưu trữ vượt quá cuối view.
Ví dụ
Sử dụng setBigInt64()
const buffer = new ArrayBuffer(10);
const dataview = new DataView(buffer);
dataview.setBigInt64(0, 3n);
dataview.getBigInt64(1); // 768n
Đặc tả kỹ thuật
| Specification |
|---|
| ECMAScript® 2027 Language Specification # sec-dataview.prototype.setbigint64 |