DataView.prototype.setBigInt64()

Метод setBigInt64() экземпляров 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 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

Синтаксис

setBigInt64(byteOffset, value)
setBigInt64(byteOffset, value, littleEndian)

Параметры

byteOffset

Смещение в байтах от начала представления, в которое нужно сохранить данные.

value

Значение, которое нужно установить как BigInt. Информацию о том, как значение кодируется в байтах, см. в разделе Кодирование и нормализация значений.

littleEndian Необязательный

Указывает, хранятся ли данные в little-endian или big-endian формате. Если false или undefined, записывается big-endian значение.

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

undefined.

Исключения

RangeError

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

Примеры

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

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

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

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

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

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