Node.js Buffer.swap16() 方法

Buffer.swap16() 方法是Buffer模块中 Buffer 类的内置应用程序编程接口，用于就地交换缓冲区字节顺序。通过将缓冲区解释为 16 位数字数组来执行交换。

句法：

Buffer.swap16()

参数：此方法不接受任何参数。

返回值：它返回对交换缓冲区的引用。

抛出的错误：如果缓冲区长度 (buf.length) 不是 2 的倍数，则抛出ERR_INVALID_BUFFER_SIZE 。

下面的例子说明了 Node.js 中Buffer.swap16()方法的使用：

示例 1：

// Node.js program to demonstrate the 
// Buffer.swap16() method 
      
// Creating a buffer 
const buf = Buffer.from([0x1, 0x2,
        0x3, 0x4, 0x5, 0x6, 0x7, 0x8]); 
  
// Display the buffer value
// before swap 
console.log(buf); 
  
// Using Buffer.swap16() method
buf.swap16();
      
// Display the result 
// after swap
console.log(buf); 

输出：

示例 2：此示例显示此方法引发的错误。

// Node.js program to demonstrate the 
// Buffer.swap16() method 
      
// Creating a buffer 
const buf = Buffer.from([0x7, 0x5, 0x2]); 
  
// Display the buffer value
// before swap 
console.log(buf); 
  
try {
    // Using Buffer.swap16() method
    // It will throw error
    buf.swap16();
  
    // Display the result 
    // after swap
    console.log(buf);
  
}
catch(e) {
    console.log("Entering catch block");
  
    // Display error
    console.log(e);
}

输出：

Entering catch block
RangeError [ERR_INVALID_BUFFER_SIZE]: Buffer size
must be a multiple of 16-bits
    at Buffer.swap16 (buffer.js:1042:11)
    at /home/runner/index.js:14:9
    ......

注意：以上程序将使用node index.js命令编译运行。

参考： https://nodejs.org/dist/latest-v13.x/docs/api/buffer.html#buffer_buf_swap16