DataView.prototype.setBigUint64()
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 setBigUint64() của các instance DataView nhận một BigInt và lưu trữ nó như một số nguyên không 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 an unsigned 64-bit integer
const max = 2n ** 64n - 1n;
const view = new DataView(buffer);
view.setBigUint64(1, max);
console.log(view.getBigUint64(1));
// Expected output: 18446744073709551615n
Cú pháp
setBigUint64(byteOffset, value)
setBigUint64(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 setBigUint64()
const buffer = new ArrayBuffer(10);
const dataview = new DataView(buffer);
dataview.setBigUint64(0, 3n);
dataview.getBigUint64(1); // 768n
Đặc tả kỹ thuật
| Specification |
|---|
| ECMAScript® 2027 Language Specification # sec-dataview.prototype.setbiguint64 |