摘要
在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