Блог

buf.readUInt16LE([offset])

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

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

Считывает 16-битное целое число без знака из buf указанного offset с указанным значением конца (readUInt16BE() читается как большой конец, readUInt16LE()читается как маленький конец).

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

console.log(buf.readUInt16BE(0).toString(16));
// Prints: 1234
console.log(buf.readUInt16LE(0).toString(16));
// Prints: 3412
console.log(buf.readUInt16BE(1).toString(16));
// Prints: 3456
console.log(buf.readUInt16LE(1).toString(16));
// Prints: 5634
console.log(buf.readUInt16LE(2).toString(16));
// Throws ERR_OUT_OF_RANGE.

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

Синтаксис:

Buffer.readUInt16LE( offset )

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

Return value (Возвращаемое значение): Он возвращает целое число из указанного смещения в формате little endian.

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

Пример 1:

// Node.js program to demonstrate the
// Buffer.readUInt16LE() method
	
// Creating a buffer
const buf = Buffer.from([0x7, 0x0,
	0x1, 0x1, 0x4, 0x5, 0x4, 0x6]);

// Using Buffer.readUInt16LE() method
console.log(buf.readUInt16BE(0).toString(16));

// Using Buffer.readUInt16LE() method
console.log(buf.readUInt16BE(6).toString(16));

// Using Buffer.readUInt16LE() method
console.log(buf.readUInt16BE(2).toString(16));

Выход:

700
406
101

Пример 2:

// Node.js program to demonstrate the
// Buffer.readUInt16LE() method
	
// Creating a buffer
const buf = Buffer.from([0x1714, 0x1024, 0x2113,
	0x2121, 0x1245, 0x1675, 0x1725, 0x1856]);

// Using Buffer.readUInt16LE() method
console.log(buf.readUInt16BE(0).toString(16));

// Using Buffer.readUInt16LE() method
console.log(buf.readUInt16BE(6).toString(16));

// Using Buffer.readUInt16LE() method
console.log(buf.readUInt16BE(10).toString(16));

Выход:

1424
2556
RangeError [ERR_OUT_OF_RANGE]: The value of "offset" is out ofrange. 
It must be >= 0 and <= 6. Received 10 at boundsError (internal/buffer.js:49:9)
 at Buffer.readUInt16BE (internal/buffer.js:215:5)
 at /home/runner/index.js:14:17
 ......

В приведенном выше примере показана ошибка, вызванная тем, что ее параметры не находятся в допустимом диапазоне.

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

Ссылка: https://nodejs.org/dist/latest-v13.x/docs/api/buffer.html#buffer_buf_readuint16le_offset