Node.js Buffer

Node.js定义了一个 Buffer 类，该类用来创建一个专门存放二进制数据的缓存区。
一、创建 Buffer 类
（1）创建长度为 10 字节的 Buffer 实例：
var buf = new Buffer(10);
（2）通过给定的数组创建 Buffer 实例：
var buf = new Buffer([10, 20, 30, 40, 50]);
（3）通过一个字符串来创建 Buffer 实例：
var buf = new Buffer("buffer。。", "utf-8");
二、写入缓冲区
语法如下所示：
buf.write(string[, offset[, length]][, encoding])
参数描述如下：

• string - 写入缓冲区的字符串。
• offset - 缓冲区开始写入的索引值，默认为 0 。
• length - 写入的字节数，默认为 buffer.length
• encoding - 使用的编码，默认为 'utf8' 。

返回值：返回实际写入的大小。如果 buffer 空间不足， 则只会写入部分字符串。
三、从缓冲区读取数据
语法如下所示：
buf.toString([encoding[, start[, end]]])
参数描述如下：

• encoding - 使用的编码，默认为 'utf8' 。
• start - 指定开始读取的索引位置，默认为 0。
• end - 结束位置，默认为缓冲区的末尾。

返回值：解码缓冲区数据并使用指定的编码返回字符串。
四、将 Buffer 转换为 JSON 对象
语法格式如下：buf.toJSON()
返回值：返回 JSON 对象。
五、缓冲区合并
语法如下所示：
Buffer.concat(list[, totalLength])
参数描述如下：

• list - 用于合并的 Buffer 对象数组列表。
• totalLength - 指定合并后Buffer对象的总长度。

返回值：返回一个多个成员合并的新 Buffer 对象。
六、缓冲区比较
语法如下所示（该方法在 Node.js v0.12.2 版本引入）：
buf.compare(otherBuffer);
参数描述如下：

• otherBuffer - 与 buf 对象比较的另外一个 Buffer 对象。

返回值：返回一个数字，表示 buf 在 otherBuffer 之前，之后或相同。
七、拷贝缓冲区
语法如下所示：
buf.copy(targetBuffer[, targetStart[, sourceStart[, sourceEnd]]])
参数描述如下：

• targetBuffer - 要拷贝的 Buffer 对象。
• targetStart - 数字, 可选, 默认: 0
• sourceStart - 数字, 可选, 默认: 0
• sourceEnd - 数字, 可选, 默认: buffer.length

八、缓冲区裁剪
语法如下所示：
buf.slice([start[, end]])
参数描述如下：

• start - 数字, 可选, 默认: 0
• end - 数字, 可选, 默认: buffer.length

返回值：返回一个新的缓冲区，它和旧缓冲区指向同一块内存，但是从索引 start 到 end 的位置剪切。
九、缓冲区长度
buf.length：返回 Buffer 对象所占据的内存长度。