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