Блог

buf.readUInt32LE([offset])

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

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

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

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

import { Buffer } from 'buffer';

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

console.log(buf.readUInt32LE(0).toString(16));
// Prints: 78563412
console.log(buf.readUInt32LE(1).toString(16));
// Throws ERR_OUT_OF_RANGE.

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

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

console.log(buf.readUInt32LE(0).toString(16));
// Prints: 78563412
console.log(buf.readUInt32LE(1).toString(16));
// Throws ERR_OUT_OF_RANGE.

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

Синтаксис:

Buffer.readUInt32LE( offset )

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

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

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

Пример 1:

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

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

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

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

Выход:

<Buffer 21 09 19 98 16 09 19 96> 98190921
16981909
9169819
19091698
96190916

Пример 2:

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

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

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

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

Выход:

<Buffer 21 09 19 98 34 ae e8 ff>
98190921
21091998
34981909
9199834
ae349819
199834ae
e8ae3498
9834aee8
ffe8ae34
34aee8ff

Пример 3:

// Node program to demonstrate the
// Buffer.readUInt32LE() 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.readUInt32LE(0).toString(16));

// Wrong index is provoded to produce error
console.log(buf.readUInt32LE(1).toString(16));

Выход:

<Buffer 21 09 19 98>
98190921
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 <= 0. Received 1
 at boundsError (internal/buffer.js:49:9)
 at Buffer.readUInt32LE (internal/buffer.js:105:5)
 at Object. (C:\nodejs\buf_readuint32le_2.js:10:17)
 . . .

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

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