DataView.prototype.setInt32() - JavaScript

DataView.prototype.setInt32() - JavaScript | MDN

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since июль 2015 г..

Метод setInt32() экземпляров DataView принимает число и сохраняет его в форме 32-битного целого числа со знаком в 4 байтах начиная с определённого в этом DataView смещении. Ограничений по выравниванию нет, многобайтовые значения могут храниться с любым смещением в пределах границ.

Интерактивный пример

// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(16);

const view = new DataView(buffer);
view.setInt32(1, 2147483647); // Max signed 32-bit integer

console.log(view.getInt32(1));
// Expected output: 2147483647

Синтаксис

setInt32(byteOffset, value)
setInt32(byteOffset, value, littleEndian)

Параметры

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

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

undefined.

Исключения

RangeError: Возникает, если byteOffset выходит за пределы DataView.

Примеры

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

const buffer = new ArrayBuffer(10);
const dataview = new DataView(buffer);
dataview.setInt32(0, 3);
dataview.getInt32(1); // 768

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

Specification
ECMAScript® 2026 Language Specification # sec-dataview.prototype.setint32