Node.js的API之Buffer的用法详解_api返回数据是buffer-CSDN博客

本文链接：https://blog.csdn.net/chen_ac/article/details/145247273

在Node.js中，Buffer是一个核心的全局对象，专门用于处理二进制数据流。下面将详细介绍Buffer的概念、意义，并结合代码给出具体例子。

一、Buffer的概念

Buffer是一个特殊的类，它类似于数组，但专门用于存储二进制数据。每个Buffer实例都有一个固定的大小，并且可以在其中存储任意类型的数据，包括文本和二进制文件。Buffer对象是由C++代码实现的底层结构，而JavaScript代码则提供了一些高级的API来操作它。

二、Buffer的意义

Buffer在Node.js中扮演着至关重要的角色，特别是在处理非文本数据（如图片、视频、音频等）时。它是Node.js处理二进制数据的关键工具，广泛应用于网络通信、文件操作、加密算法等场景。

三、Buffer的API及代码示例

Buffer引入

const { Buffer } = require('buffer');

创建Buffer

Buffer.alloc(size[, fill[, encoding]])：分配一个指定大小的Buffer实例，并可选地用指定的值填充。如果未指定fill，则默认填充为0。

const buf1 = Buffer.alloc(10); // 创建一个长度为10的Buffer，并用0填充
console.log(buf1); // <Buffer 00 00 00 00 00 00 00 00 00 00>

Buffer.allocUnsafe(size)：分配一个指定大小的Buffer实例，但不会将其初始化为零。因此，新创建的Buffer实例可能会包含旧数据，使用时需要注意安全性。

const buf2 = Buffer.allocUnsafe(10); // 创建一个长度为10的未初始化Buffer
console.log(buf2); // 内容可能不是全0，因为未初始化

Buffer.from(array)：通过一个字节数组创建一个新的Buffer实例。

const buf3 = Buffer.from([1, 2, 3, 4]); // 创建一个包含[1, 2, 3, 4]的Buffer
console.log(buf3); // <Buffer 01 02 03 04>

Buffer.from(string[, encoding])：创建一个包含字符串的Buffer实例，encoding表示字符串的字符编码。如果未指定encoding，则默认为’utf8’。

const buf4 = Buffer.from('hello', 'utf8'); // 创建一个包含字符串"hello"的Buffer
console.log(buf4.toString()); // hello

操作Buffer

buf.toString([encoding[, start[, end]]])：根据指定的编码将Buffer转换为字符串。start和end参数用于指定要转换的Buffer范围。

const buf = Buffer.from('Node.js');
console.log(buf.toString('utf8', 0, 6)); // Node.js

buf.write(string[, offset[, length]][, encoding])：将字符串写入Buffer。offset是开始写入的索引值，length是要写入的字节数，encoding是使用的编码。

const buf = Buffer.alloc(10);
buf.write('Hi', 0, 2, 'utf8'); // 在Buffer的开头写入"Hi"
console.log(buf.toString('utf8')); // Hi\x00\x00\x00\x00\x00\x00\x00

buf.copy(target[, targetStart[, sourceStart[, sourceEnd]]])：将Buffer的一部分复制到另一个Buffer。

const buf1 = Buffer.from('abcdef');
const buf2 = Buffer.alloc(4);
buf1.copy(buf2, 2, 2, 4); // 将buf1中从索引2开始的2个字节复制到buf2中从索引2开始的位置
console.log(buf2.toString('utf8')); // \x00\x00cd

buf.fill(value[, offset[, end]][, encoding])：用指定值填充Buffer。

const buf = Buffer.alloc(5);
buf.fill('a'); // 用字符'a'的ASCII码填充整个Buffer
console.log(buf.toString('utf8')); // aaaaa

比较Buffer

buf.equals(otherBuffer)：检查两个Buffer是否相等。如果两个Buffer的长度和内容都相同，则返回true，否则返回false。

const buf1 = Buffer.from('abc');
const buf2 = Buffer.from('abc');
const buf3 = Buffer.from('abcd');
console.log(buf1.equals(buf2)); // true
console.log(buf1.equals(buf3)); // false

buf.compare(otherBuffer)：比较两个Buffer的字节顺序。返回值为整数，表示buf和otherBuffer的大小关系。如果返回0，表示两者相等；如果返回负数，表示buf小于otherBuffer；如果返回正数，表示buf大于otherBuffer。

const buf1 = Buffer.from('ABC');
const buf2 = Buffer.from('BCD');
const buf3 = Buffer.from('ABCD');
console.log(buf1.compare(buf2)); // -1，因为'A'<'B'
console.log(buf1.compare(buf3)); // -1，因为buf1比buf3短
console.log(buf2.compare(buf1)); // 1，因为'B'>'A'