Блог

buf.readUIntBE(offset, byteLength)

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

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

Считывает byteLength количество байтов из buf указанного offset и интерпретирует результат как целое число большого конца без знака, поддерживающее точность до 48 бит.

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

import { Buffer } from 'buffer';

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

console.log(buf.readUIntBE(0, 6).toString(16));
// Prints: 1234567890ab
console.log(buf.readUIntBE(1, 6).toString(16));
// Throws ERR_OUT_OF_RANGE.

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

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

console.log(buf.readUIntBE(0, 6).toString(16));
// Prints: 1234567890ab
console.log(buf.readUIntBE(1, 6).toString(16));
// Throws ERR_OUT_OF_RANGE.

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

Синтаксис:

Buffer.readUIntBE( offset, byteLength )

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

• offset (смещение): Он указывает количество байтов, которые необходимо пропустить перед чтением, или просто указывает индекс в буфере. Значение смещения лежит 0 <= offset <= Buffer.length – byteLength  его значение по умолчанию равно 0.
• byteLength (По длине): В нем указывается количество считываемых байтов. Значение лоэ по длине 0 < Длина байта.

Возврат: Этот метод возвращает целое значение, которое считывается из буфера в формате Big Endian.

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

Пример 1:

// Node program to demonstrate the
// Buffer.readUIntBE() Method

// Allocating buffer from array
const buf = Buffer.from([0x21, 0x09, 0x19, 0x98]);

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

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

Выход:

<Buffer 21 09 19 98> 210919
91998
1998

Пример 2:

// Node program to demonstrate the
// Buffer.readUIntBE() Method

// Allocating buffer from array
const buf = Buffer.from([0x21, 0x09, 0x19, 0x98]);

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

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

Выход:

<Buffer 21 09 19 98>
210919
190921
919
1909
19
19

Пример 3:

// Node program to demonstrate the
// Buffer.readUIntBE() Method

// Allocating buffer from array
const buf = Buffer.from([0x21, 0x09, 0x19, 0x98]);

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

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

// Wrong index is provoded to produce error
console.log(buf.readUIntBE(3, 6).toString(16));

Выход:

<Buffer 21 09 19 98>
21091998
919
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 <= 1. Received 2
 at boundsError (internal/buffer.js:49:9)
 at readUInt24BE (internal/buffer.js:205:5)
 at Buffer.readUIntBE (internal/buffer.js:148:12)
 . . . 

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

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