This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

DataView.prototype.setInt32()

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

Синтаксис

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

Параметры

byteOffset

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

value

Устанавливаемое значение. На данный момент значение кодируется в байтах.

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

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

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

undefined.

Исключения

RangeError

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

Примеры

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

js
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

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

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