《超实用的Node.js代码段》连载二：正确拼接Buffer

   对于初学Node.js框架的开发人员来说，可能认为Buffer模块比较易学、重要性也不是那么突出。其实，Buffer模块在文件I/O和网络I/O中应用非常广泛，其处理二进制的性能比普通字符串性能要高出很多，重要性可谓是举足轻重。下面我们通过一个例程向读者演示一下，使用buf.concat()方法进行拼接的过程。

   本例ch04.buffer-concat.js主要代码如下：

/** 
 * ch04.buffer-concat.js 
 */  
console.info("------   Buffer concat vs String concat  ------");  
console.info();  
/** 
 * define variable 
 * @type {Buffer} 
 */  
var buf = new Buffer("this is Buffer concat test!");  
var str = "this is String concat test!";  
/** 
 * start record time 
 */  
console.time("buffer concat test!");  
var list = [];  
var len = 100000 * buf.length;  
for(var i=0; i<100000; i++){  
    list.push(buf);  
    len += buf.length;  
}  
/** 
 * Buffer 对象拼接 
 */  
var s1 = Buffer.concat(list, len).toString();  
console.timeEnd("buffer concat test!");  
console.info();  
console.time("string concat test!");  
var list = [];  
for(var i=100000; i>=0; i--) {  
    list.push(str);  
}  
/** 
 * String 对象拼接 
 * @type {string} 
 */  
var s2 = list.join("");  
console.timeEnd("string concat test!");  
/** 
 * end record time 
 */  
console.info();  
console.info("------   Buffer concat vs String concat  ------");  

【代码分析】

  第10行代码定义了一个Buffer对象，变量名为buf，并初始化了一个字符串数据（"thisis Buffer concat test!"）；第11行代码定义了一个字符串变量str，并初始化了一个字符串数据（"thisis String concat test!"）；从第15行代码开始到第26行代码结束，通过console.time()和console.timeEnd()方法完成一段时间间隔记录；第16～21行代码定义了一个数组变量list[]，并使用buf变量对该数组变量进行初始化；第25行代码通过Buffer.concat(list,len)方法将list[]数组中的编码重新拼接成一个Buffer对象，关于Buffer.concat(list,len)方法的语法说明如下：

 

语法：Buffer.concat(list,[totalLength])  

参数说明：

•  list{Array}：数组类型，Buffer数组，用于被连接
•  totalLength：{Number}类型，第一个参数Buffer数组对象的总大小

     该方法返回一个保存着将传入buffer数组中所有buffer对象拼接在一起的buffer对象；如果传入的数组没有内容，或者totalLength参数是0，那将返回一个zero-length的buffer；如果数组中只有一项，那么这第一项就会被返回；如果数组中的项多于一个，那么一个新的Buffer对象实例将被创建；如果totalLength参数没有提供，虽然会从buffer数组中计算读取，但是会增加一个额外的循环来计算该长度，因此提供一个明确的totalLength参数将会使得Buffer.concat()方法执行的更快；

从图4.10中显示的结果可以看到，使用Buffer.concat(list,len)方法进行拼接的耗时为48ms。

图4.10  Buffer对象拼接功能

注意：Buffer.concat(list, [totalLength])方法的第2个参数totalLength比较特别，这里的totalLength不是数组长度是数组里Buffer实例的大小总和。