You are currently viewing Node.js Buffer | Метод Buffer.swap32()

Node.js Buffer | Метод Buffer.swap32()

buf.swap32()

Добавлено в: v5.10.0

  • Возвращает: <Буфер> Ссылку на buf.

Интерпретируется buf как массив 32-разрядных целых чисел без знака и меняет порядок байтов на месте. Бросает ERR_INVALID_BUFFER_SIZE, если buf.length не кратно 4.

const buf1 = Buffer.from([0x1, 0x2, 0x3, 0x4, 0x5, 0x6, 0x7, 0x8]);

console.log(buf1);
// Prints: <Buffer 01 02 03 04 05 06 07 08>

buf1.swap32();

console.log(buf1);
// Prints: <Buffer 04 03 02 01 08 07 06 05>

const buf2 = Buffer.from([0x1, 0x2, 0x3]);

buf2.swap32();
// Throws ERR_INVALID_BUFFER_SIZE.

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

Синтаксис:

Buffer.swap32()

Параметры: Этот метод не принимает никаких параметров.

Return value (Возвращаемое значение): Он возвращает ссылку на замененный буфер.

Выдана ошибка: Это бросает ERR_INVALID_BUFFER_SIZE если длина буфера (buf.длина) не кратна 4.

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

Пример 1:

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

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

// Using Buffer.swap32() method
buf.swap32();
	
// Display the result
// after swap
console.log(buf);

Выход:

<Buffer 07 00 01 01 04 05 04 06>
<Buffer 01 01 00 07 06 04 05 04>

Пример 2: В этом примере отображается ошибка, вызванная этим методом.

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

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

try {
	// Using Buffer.swap32() method
	// It will throw error
	buf.swap32();

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

}
catch(e) {
	console.log("Entering catch block");

	// Display error
	console.log(e);
}

Выход:

<Buffer 00 01>
Entering catch block
RangeError [ERR_INVALID_BUFFER_SIZE]: Buffer size
must be a multiple of 32-bits
    at Buffer.swap32 (buffer.js:1042:11)
    at /home/runner/index.js:14:9
    ......

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

Ссылка: https://nodejs.org/dist/последняя версия-v13.x/docs/api/buffer.html#buffer_buf_swap32