Блог

buf.readUInt16BE([offset])

Версия	Изменения
v14.9.0, v12.19.0	Эта функция также доступна как buf.readUint16BE().
v10.0.0	Удалено noAssert, и больше нет неявного принуждения к смещению uint32.
v0.5.5	Добавлено в: v0.5.5

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

Считывает 16-разрядное целое число без знака с большим концом из buf указанного offset.

Эта функция также доступна под readUint16BE псевдонимом.

import { Buffer } from 'buffer';

const buf = Buffer.from([0x12, 0x34, 0x56]);

console.log(buf.readUInt16BE(0).toString(16));
// Prints: 1234
console.log(buf.readUInt16BE(1).toString(16));
// Prints: 3456

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

const buf = Buffer.from([0x12, 0x34, 0x56]);

console.log(buf.readUInt16BE(0).toString(16));
// Prints: 1234
console.log(buf.readUInt16BE(1).toString(16));
// Prints: 3456

Метод Buffer.readUInt16BE() представляет собой встроенный интерфейс прикладного программирования класса Buffer в модуле Buffer, который используется для считывания 16-разрядного значения из выделенного буфера с заданным смещением.

Синтаксис:

Buffer.readUInt16BE( offset )

Параметры: Этот метод принимает один параметр смещение это указывает количество байтов, которые нужно пропустить перед чтением, или просто указывает индекс в буфере. Значение буфера лежит 0 <= смещение. Его значение по умолчанию равно 0.

Return Value (Возвращаемое Значение): Этот метод возвращает 16-разрядное целое значение без знака, которое считывается из буфера в формате big endian (Buffer.readUInt16LE() считывает 16 бит в формате little endian).

Приведенные ниже примеры иллюстрируют использование метода Buffer.readUInt16BE() в Node.js:

Пример 1:

// Node.js program to demonstrate the
// Buffer.readUInt16BE() method
	
// Allocating buffer from array
const buf = Buffer.from([0x21, 0x09, 0x19, 0x98]);

// Printing allocated buffer
console.log(buf);

// Reading 16bits data from the buffer
// and printing it as a string
console.log(buf.readUInt16BE(0).toString(16));
console.log(buf.readUInt16BE(1).toString(16));
console.log(buf.readUInt16BE(2).toString(16));

Выход:

<Buffer 21 09 19 98>
2109
919
1998

Пример 2:

// Node.js program to demonstrate the
// Buffer.readUInt16BE() method
	
// Allocating buffer from array
const buf = Buffer.from([0x21, 0x09, 0x19, 0x98]);

// Printing allocated buffer
console.log(buf);

// Reading 16bits data from the buffer
// and printing it as a string
console.log(buf.readUInt16BE(0).toString(16));
console.log(buf.readUInt16LE(0).toString(16));
console.log(buf.readUInt16BE(1).toString(16));
console.log(buf.readUInt16LE(1).toString(16));
console.log(buf.readUInt16BE(2).toString(16));
console.log(buf.readUInt16LE(2).toString(16));

Выход:

<Buffer 21 09 19 98> 2109
921
919
1909
1998
9819

Пример 3:

// Node.js program to demonstrate the
// Buffer.readUInt16BE() method
	
// Allocating buffer from array
const buf = Buffer.from([0x21, 0x09, 0x19, 0x98]);

// Printing allocated buffer
console.log(buf);

// Reading 16bits data from the buffer
// and printing it as a string
console.log(buf.readUInt16BE(0).toString(16));
console.log(buf.readUInt16BE(1).toString(16));
console.log(buf.readUInt16BE(2).toString(16));

// Wrong index is provided to produce error
console.log(buf.readUInt16BE(3).toString(16));

Выход:

<Buffer 21 09 19 98>
2109
919
1998
internal/buffer.js:49
  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
    at boundsError (internal/buffer.js:49:9)
    at Buffer.readUInt16BE (internal/buffer.js:215:5)
    . . .

Примечание: Приведенная выше программа будет скомпилирована и запущена с помощью node index.js команды.

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