首页 > 代码库 > [Node.js]Buffer

[Node.js]Buffer

摘要

在js中是没有二进制类型的,但在处理tcp或者文件流时,必须使用到二进制数据,因此Node.js定义了一个Buffer类型,该类型用来创建一个专门存储二进制数据的缓存区。在Node.js中,Buffer类是随Node内核一起发布的核心库。Buffer库为Node.js带来了一种存储原始数据的办法,可以让Node.js处理二进制数据,每当需要在Node.js中处理I/O操作中移动的数据时,就有可能使用Buffer库。原始数据存储在Buffer类的实例中。一个Buffer类似于证书数组,但她对应于V8堆内存之外的一块原始内存。

创建Buffer类

Buffer可以通过多种方式创建。

//方式一var buf=new Buffer(10);//方式二 通过给定的数组 创建Buffer实例var buf2=new Buffer([10,20,30,40,50]);//方式三 通过一个字符串创建Buffer实例//utf-8是默认的编码方式,此外它同样支持一下编码:“ascii”,“utf8”,"utf16le","ucs2","base64"."hex"var buf3=new Buffer("Hello buffer wolrd","utf-8");

写入缓存区

语法

buf.write(sttring[,offset[,length]][,encoding])

参数描述

string:写入缓存区的字符串。

offset:缓存区开始写入的位置索引,默认为0.

length:写入的字节数,默认为buffer.length.

encoding:使用的编码,默认为utf8.

返回值

返回实际写入的大小。如果buffer空间不足,则会写入部分字符串。

一个例子:

var buf=new Buffer(256);var len=buf.write("Hello buffer world");console.log("写入字节数:"+len);

执行

技术分享

读取数据

语法

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

参数描述

encoding:使用编码,默认为utf8.

start:开始读取的位置索引。默认为0

end:结束位置索引,默认为缓冲区的末尾。

返回值

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

一个例子

var buf=new Buffer(26);for (var i = 0; i <26; i++) {    buf[i]=i+97;};console.log(buf.toString("ascii"));console.log(buf.toString("ascii",0,5));console.log(buf.toString("utf8",0,5));console.log(buf.toString(undefined,0,5));

技术分享

将Buffer转换为Json对象

语法

buf.toJSON()

返回值

返回json对象。

一个例子

var buf=new Buffer("Hello buffer world.");var json=buf.toJSON();console.log(json);

技术分享

缓冲区合并

语法

Buffer.concat(list[,totalLength])

参数描述

list:用于合并的Buffer对象数据列表。

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

返回值

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

一个例子

var buf1=new Buffer("Hello buffer ");var buf2=new Buffer("world.");var buf3=Buffer.concat([buf1,buf2]);console.log("合并后内容:"+buf3.toString());

执行

技术分享

缓冲区比较

Buffer的比较函数在Node.js v0.12.2版本引入,语法如下

buf.compare(otherBuffer)

参数

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

返回值

返回一个数字,标识buf在otherBuffer之前,之后或者相同。

一个例子

var buf1=new Buffer("ABC");var buf2=new Buffer("ABCD");var result=buf1.compare(buf2);if (result<0) {    console.log(buf1+" 在 "+buf2+" 之前");}else if(result==0){    console.log(buf1+" 与 "+buf2+" 相同");}else{    console.log(buf1+" 在 "+buf2+" 之后");}

技术分享

拷贝缓存区

语法

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

参数

targetBuffer:要拷贝的Buffer对象。

targetStart:要拷贝的对象开始位置,默认0.

sourceStart:源对象开始位置,默认0

sourceEnd:源对象结束位置,默认0

无返回值。

一个例子

var buf1=new Buffer("ABC");var targetBuf=new Buffer(3);buf1.copy(targetBuf);console.log(targetBuf.toString());

技术分享

缓冲区裁剪

语法

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

参数

start:开始裁剪位置。

end:结束位置。

返回值

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

一个例子

var buf1=new Buffer("wolfy");var buf2=buf1.slice(0,2);console.log(buf2.toString());

技术分享

缓存区长度

语法

buf.length

返回值

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

一个例子

var buf1=new Buffer("wolfy");var buf2=buf1.slice(0,2);console.log(buf2.toString());console.log(buf2.length);

技术分享

方法参考手册

http://www.runoob.com/nodejs/nodejs-buffer.html

[Node.js]Buffer