Блог

buf.writeInt16BE(value[, offset])

Версия	Изменения
v10.0.0	Удалено noAssert, и больше нет неявного принуждения к смещению uint32.
v0.5.5	Добавлено в: v0.5.5

• value <целое число> Число, в которое нужно записать buf.
• offset <целое число> Количество байтов, которые необходимо пропустить перед началом записи. 
• Должен удовлетворить 0 <= offset <= buf.length - 2. 
• По умолчанию: 0.
• Возвращает: <целое число> offset плюс количество записанных байтов.

Записывает valuebuf в указанный offset как big-endian. Значение value должно быть допустимым 16-разрядным целым числом со знаком. Поведение не определено, если value это что-либо иное, чем 16-разрядное целое число со знаком.

Значение value интерпретируется и записывается как целое число со знаком, дополняющее два.

import { Buffer } from 'buffer';

const buf = Buffer.allocUnsafe(2);

buf.writeInt16BE(0x0102, 0);

console.log(buf);
// Prints: <Buffer 01 02>

const { Buffer } = require('buffer');

const buf = Buffer.allocUnsafe(2);

buf.writeInt16BE(0x0102, 0);

console.log(buf);
// Prints: <Buffer 01 02>

Метод Buffer.writeInt16BE() представляет собой встроенный интерфейс прикладного программирования класса Buffer в модуле Buffer, который используется для записи целочисленного значения в буфер с указанным смещением в формате big-endian. Целочисленное значение должно быть допустимым 16-разрядным целым числом со знаком. Ошибка возникает, если значение выходит за пределы 16-разрядного целого числа со знаком. Целочисленное значение интерпретируется и записывается как целое число со знаком, дополняющим два.

Синтаксис:

Buffer.writeInt16BE( value, offset )

Параметры: Этот метод принимает два параметра, как указано выше и описано ниже:

• value (ценность): Это 16-разрядное целое число со знаком, которое должно быть записано в буфер.
• offset (смещение): Это целочисленное значение, т. е. количество байтов, которые необходимо пропустить перед началом записи в буфер. Значение смещения лежит 0 to buf.length-2. Это необязательный параметр, и его значение по умолчанию равно 0.

Return Value (Возвращаемое Значение): Он возвращает целое значение, представляющее собой сумму смещения плюс количество записанных байтов.

Ниже приведены примеры, иллюстрирующие использование buf.writeInt16BE() способ в Node.js:

Пример 1:

// Node.js program to demonstrate the
// Buffer.writeInt16BE() Method
	
// Allocate a buffer
const buf = Buffer.allocUnsafe(2);

// Writing the value to the buffer
buf.writeInt16BE(0x7bca);

// Display the buffer value
console.log(buf);

Выход:

<Buffer 7b ca>

Пример 2:

// Node.js program to demonstrate the
// Buffer.writeInt16BE() Method
	
// Allocate a buffer
const buf = Buffer.allocUnsafe(4);

// Writing the value to the buffer
// from 0 offset
buf.writeInt16BE(0x7bca, 0);

// Writing the value to the buffer
// from 2 offset
buf.writeInt16BE(0x7fff, 2);

// Display the result
console.log(buf);

Выход:

<Buffer 7b ca 7f ff>

Пример 3:

// Node.js program to demonstrate the
// Buffer.writeInt16BE() Method
	
// Allocate a buffer
const buf = Buffer.allocUnsafe(4);

// Writing the value to the buffer
// from 0 offset
buf.writeInt16BE(0x7bca, 0);

// Writing the value to the buffer
// from 2 offset
buf.writeInt16BE(0x7fff, 3);

// Display the result
console.log(buf);

Выход:

internal/buffer.js:72
  throw new ERR_OUT_OF_RANGE(type || 'offset',
  ^
RangeError [ERR_OUT_OF_RANGE]: The value of "offset" is out of range.
It must be >= 0 and <= 2. Received 3
. . .

Ссылка: https://nodejs.org/api/buffer.html#buffer_buf_writeint16be_value_offset