nodejs基础 -- buffer缓冲区

JavaScript 语言自身只有字符串数据类型，没有二进制数据类型。但在处理像TCP流或文件流时，必须使用到二进制数据。因此在 Node.js中，定义了一个 Buffer 类，该类用来创建一个专门存放二进制数据的缓存区。在 Node.js 中，Buffer 类是随 Node 内核一起发布的核心库。Buffer 库为 Node.js 带来了一种存储原始数据的方法，可以让 Node.js 处理二进制数据，每当需要在Node.js 中处理I/O操作中移动的数据时，就有可能使用 Buffer 库。原始数据存储在 Buffer 类的实例中。一个 Buffer 类似于一个整数数组，但它对应于 V8 堆内存之外的一块原始内存。

 

创建buffer类

1、创建长度为指定字节的buffer实例

var buffer = new Buffer(10); //创建长度为10字节的buffer实例

2、通过数组创建buffer实例

var buffer = new Buffer([10,20,30,40,50]);

3、通过一个字符串来创建buffer实例

var buffer = new Buffer('www.google.com','utf-8'); //utf-8 是默认的编码方式，此外还可以指定以下编码："ascii", "utf8", "utf16le", "ucs2", "base64" 和 "hex"

 

缓冲区长度

语法：

buf.length;

返回值：

返回 Buffer 对象所占据的内存长度。

实例：

var buffer = new Buffer('www.runoob.com');
//  缓冲区长度
console.log("buffer length: " + buffer.length); //buffer length: 14

 

写入缓冲区

语法：

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

参数：

string：写入缓冲区的字符串。

offset：缓冲区开始写入的索引值，默认为 0 。

length：写入的字节数，默认为 buffer.length

encoding：使用的编码。默认为 'utf8' 。

返回值：

返回实际写入的大小（number类型）。如果 buffer 空间不足， 则只会写入部分字符串。

实例：

buf = new Buffer(256);
len = buf.write("www.runoob.com");
console.log("写入字节数 : "+  len); //写入字节数 : 14

 

 

从缓冲区读取数据

语法：

buf.toString([encoding][, start][, end])

参数：

encoding：使用的编码，默认为utf-8

start：指定开始读取的索引位置，默认为0

end：指定读取的结束位置，默认为缓冲区的末尾

返回值：

解码缓冲区数据，并使用指定的编码返回字符串

实例：

buf = new Buffer(26);
for (var i = 0 ; i < 26 ; i++) {
  buf[i] = i + 97;
}

console.log( buf.toString('ascii'));       // 输出: abcdefghijklmnopqrstuvwxyz
console.log( buf.toString('ascii',0,5));   // 输出: abcde
console.log( buf.toString('utf8',0,5));    // 输出: abcde
console.log( buf.toString(undefined,0,5)); // 使用 'utf8' 编码, 并输出: abcde

 

buffer对象转换成json对象

语法：

toJSON()方法

返回值：

json对象

实例：

var buf = new Buffer('www.google.com');
var json = buf.toJSON(buf);
console.log(json);  //[ 119, 119, 119, 46, 103, 111, 111, 103, 108, 101, 46, 99, 111, 109 ]

 

缓冲区合并

语法：

Buffer.concat(list[, totalLength])

参数：

list：用于合并的 Buffer 对象数组列表。

totalLength：指定合并后Buffer对象的总长度。

返回值：

返回一个多个成员合并的新 Buffer 对象。

实例：

var buf1 = new Buffer("谷歌网址：");
var buf2 = new Buffer("www.google.com");
var buf3 = Buffer.concat([buf1,buf2]);
console.log('buf1的内容为：'+buf1.toString()); //buf1的内容为：谷歌网址：
console.log('buf2的内容为：'+buf2.toString()); //buf2的内容为：www.google.com
console.log('buf3的内容为：'+buf3.toString()); //buf3的内容为：谷歌网址：www.google.com

 

缓冲区拷贝

语法：

buf.copy(targetBuffer[, targetStart][, sourceStart][, sourceEnd])

参数：

参数描述如下：

targetBuffer - 要拷贝的 Buffer 对象。

targetStart - 数字, 可选, 默认: 0

sourceStart - 数字, 可选, 默认: 0

sourceEnd - 数字, 可选, 默认: buffer.length

返回值：

没有返回值。

实例：

var buf1 = new Buffer('ABC');
// 拷贝一个缓冲区
var buf2 = new Buffer(2);
var buf3 = new Buffer(3);
var buf4 = new Buffer(5);
var buf5 = new Buffer('abcdef');
buf1.copy(buf2);
buf1.copy(buf3);
buf1.copy(buf4);
buf1.copy(buf5);
console.log("buf2 content: " + buf2.toString()); //buf2 content: AB
console.log("buf3 content: " + buf3.toString()); //buf3 content: ABC
console.log("buf4 content: " + buf4.toString()); //buf4 content: ABC 因为开辟出来的内存大了些，所以这里接一堆怪符号
console.log("buf5 content: " + buf5.toString()); //buf5 content: ABCdef

 

缓冲区裁剪

语法：

buf.slice([start][, end])

参数：

参数描述如下：

• start - 数字, 可选, 默认: 0

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

返回值：

返回一个新的缓冲区，它和旧缓冲区指向同一块内存，但是从索引 start 到 end 的位置剪切。

实例：

var buffer1 = new Buffer('runoob');
// 剪切缓冲区
var buffer2 = buffer1.slice(0,2);
console.log("buffer2 content: " + buffer2.toString()); //buffer2 content: ru