Spec-Zone.ru › JavaScript

DataView.prototype.setBigUint64()

Базовая версия Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с сентября 2021 года.

Метод setBigUint64() экземпляров DataView принимает BigInt и сохраняет его как 64-битное беззнаковое целое число в 8 байтах, начиная с указанного байтового смещения этого DataView. Ограничений на выравнивание нет; многобайтовые значения могут храниться с любым смещением в пределах границ.

Попробуйте

// 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

Синтаксис

setBigUint64(byteOffset, value)
setBigUint64(byteOffset, value, littleEndian)

Параметры

byteOffset
Смещение (в байтах) от начала представления, куда будут записываться данные.
value
Значение, которое нужно установить в виде BigInt. О том, как значение кодируется в байтах, см. Кодирование и нормализация значений.
littleEndian Необязательный
Указывает, хранятся ли данные в little- или big-endian формате. Если false или undefined, записывается значение в формате big-endian.

Возвращаемое значение

undefined.

Исключения

RangeError
Выбрасывается, если byteOffset установлено так, что запись данных выйдет за пределы представления.

Примеры

Использование setBigUint64()

const buffer = new ArrayBuffer(10);
const dataview = new DataView(buffer);
dataview.setBigUint64(0, 3n);
dataview.getBigUint64(1); // 768n

Спецификации

Спецификация
Спецификация языка ECMAScript® 2027
# sec-dataview.prototype.setbiguint64

Совместимость с браузерами

Десктопные Мобильные Серверные
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on iOS Samsung Internet WebView Android WebView on iOS Bun Deno Node.js
setBigUint64
67
79
68
54
15
67
68
48
15
9.0
67
15
1.0.0
1.0
10.4.0

Смотрите также

  • Руководство по типизированным массивам JavaScript
  • DataView
  • ArrayBuffer
  • BigUint64Array

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView/setBigUint64

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API