Node.js Buffer.write() 方法

在 Node.js 中， Buffer 类是用来处理以字节序列形式表示的数据，类似于 JavaScript 的内置类型 Array 对象，但是 Buffer 处理的是原始的二进制数据而不是 Unicode 字符。Buffer.write() 方法是 Buffer 类的实例方法之一，用于向 Buffer 对象写入数据。

语法

Buffer.write(string[, offset[, length]][, encoding])

参数

• string：要写入的字符串数据
• offset：写入的起始位置，默认为 0
• length：写入的最大长度，默认为 buffer.length - offset
• encoding：将字符串编码为字节序列的编码方式。默认为 'utf8'。

返回值

返回写入数据的实际长度。

示例

const buf = Buffer.alloc(10);
const len = buf.write('hello');
console.log(`${len} bytes: ${buf.toString()}`);  // 5 bytes: hello\0\0\0\0

上述代码中，我们先创建一个长度为 10 的 Buffer 对象，然后通过 buf.write() 方法向其写入字符串数据 hello。由于 hello 本身只占用了 5 个字节，因此剩余 5 个字节会被填充为 \0。最后通过 buf.toString() 方法将其转换成字符串输出。

注意事项

• 如果写入的字符串超出了指定的长度，即便其实际长度较大，也只会写入指定长度的数据到 Buffer 对象中。例如：

  const buf = Buffer.alloc(5);
  const len = buf.write('hello world');
  console.log(`${len} bytes: ${buf.toString()}`);  // 5 bytes: hello
  

• 如果 offset 的值超出了 Buffer 对象的长度，也会抛出 RangeError 异常。

• 如果 string 和 encoding 参数的值不匹配，则可能会导致写入数据的长度不为 string 的实际长度。

适用场景

Buffer.write() 方法适用于需要在 Buffer 对象中动态写入数据的场景，例如处理二进制文件、进行加密解密操作、网络传输等。由于 Buffer 对象长度固定，因此我们需要根据具体需求动态调整写入的长度。例如，在读取文件时，我们通常需要先获得文件的长度，然后将其读取到 Buffer 对象中。在写入文件时，我们也需要根据需要将 Buffer 对象的指定部分写入到文件中。