Книга: JavaScript. Подробное руководство, 6-е издание

DataView

DataView

реализует чтение/запись значений в ArrayBuffer (ArrayBufferView)

DataView - это подтип ArrayBufferView, который служит оберткой для ArrayBuffer (или фрагмента ArrayBuffer) и определяет методы чтения/записи 1-, 2- и 4-байтовых целых со знаком и без знака, а также 4- и 8-байтовых вещественных чисел в буфере. Методы поддерживают прямой (big-endian) и обратный (little-endian) порядок следования байтов. См. также TypedArray.

Конструктор

new DataView(ArrayBuffer buffer, [unsigned long byteOffset], [unsigned long byteLength])

Этот конструктор создает новый объект DataView, обеспечивающий доступ на чтение и запись к байтам в буфере или во фрагменте буфера. При вызове с одним аргументом создает представление всего буфера. При вызове с двумя аргументами создает представление, простирающееся от байта с номером byteOffset до конца буфера. И при вызове с тремя аргументами создает представление длиной byteLength, начинающееся с байта с номером byteOffset.

Методы

Следующие методы читают или записывают числовые значения в буфер ArrayBuffer, представленный объектом DataView. Имя метода определяет тип читаемого или записываемого числового значения. Все методы, выполняющие чтение или запись более одного байта, принимают необязательный последний аргумент littleEndian. Если этот аргумент отсутствует или имеет значение false, используется прямой (big-endian) порядок следования байтов, когда старшие байты читаются или записываются первыми. Однако если этот аргумент имеет значение true, используется обратный (little-endian) порядок следования байтов.

float getFloat32(unsigned long byteOffset, [boolean littleEndian])

Интерпретирует 4 байта, начиная с позиции byteOffset, как вещественное число и возвращает его.

double getFloat64(unsigned long byteOffset, [boolean littleEndian])

Интерпретирует 8 байтов, начиная с позиции byteOffset, как вещественное число и возвращает его.

short getlnt16(unsigned long byteOffset, [boolean littleEndian])

Интерпретирует 2 байта, начиная с позиции byteOffset, как целое число со знаком и возвращает его.

long getlnt32(unsigned long byteOffset, [boolean littleEndian])

Интерпретирует 4 байта, начиная с позиции byteOffset, как целое число со знаком и возвращает его.

byte getlnt8(unsigned long byteOffset)

Интерпретирует байт в позиции byteOffset, как целое число со знаком и возвращает его.

unsigned short getUint16(unsigned long byteOffset,[boolean littleEndian])

Интерпретирует 2 байта, начиная с позиции byteOffset, как целое число без знака и возвращает его.

unsigned long getUint32(unsigned long byteOffset, [boolean littleEndian])

Интерпретирует 4 байта, начиная с позиции byteOffset, как целое число без знака и возвращает его.

unsigned byte getUint8(unsigned long byteOffset)

Интерпретирует байт в позиции byteOffset, как целое число без знака и возвращает его.

void setFloat32(unsigned long byteOffset, float value, [boolean littleEndian])

Преобразует значение value в 4-байтовое вещественное представление и записывает полученные байты в буфер, начиная с позиции byteOffset.

void setFloat64(unsigned long byteOffset, double value, [boolean littleEndian])

Преобразует значение value в 8-байтовое вещественное представление и записывает полученные байты в буфер, начиная с позиции byteOffset.

void setlnt16(unsigned long byteOffset, short value, [boolean littleEndian])

Преобразует значение value в 2-байтовое целочисленное представление и записывает полученные байты в буфер, начиная с позиции byteOffset.

void setlnt32(unsigned long byteOffset, long value, [boolean littleEndian])

Преобразует значение value в 4-байтовое целочисленное представление и записывает полученные байты в буфер, начиная с позиции byteOffset.

void setlnt8(unsigned long byteOffset, byte value)

Преобразует значение value в 1-байтовое целочисленное представление и записывает полученный байт в буфер, в позицию byteOffset.

void setUint16(unsigned long byteOffset, unsigned short value,[boolean littleEndian])

Преобразует значение value в 2-байтовое целочисленное представление без знака и записывает полученные байты в буфер, начиная с позиции byteOffset.

void setUint32(unsigned long byteOffset, unsigned long value, [boolean littleEndian])

Преобразует значение value в 4-байтовое целочисленное представление без знака и записывает полученные байты в буфер, начиная с позиции byteOffset.

void setUint8(unsigned long byteOffset, octet value)

Преобразует значение value в 1-байтовое целочисленное представление без знака и записывает полученный байт в буфер в позицию byteOffset.

Оглавление книги