Pure JavaScript is Unicode-friendly but not nice to binary data. When dealing with TCP streams or the file system, it's necessary to handle octet streams. Node.js has several strategies for manipulating, creating, and consuming octet streams.
Raw data is stored in instances of the Buffer class. A Buffer is similar to an array of integers but corresponds to a raw memory allocation outside the V8 heap. A Buffer cannot be resized.
先用我那捉鸡的E文水平翻译下这段node.js的文档：
Javascript是一门unicode友好的语言，但并不支持二进制数据。当要处理tcp流或文件流的时候，必须使用字节流。Node.js有很多处理、生产或者消费字节流的方法。
原始数据保存在Buffer类的实例中。一个Buffer似于一个整数数组，但它对应于V8堆内存之外的一块原始内存。Buffer实例的长度不能改变。
尽管这是一段捉鸡的翻译，但我们至少可以理解Buffer的如下特性：
首先，Buffer是node.js用于解决javascript不支持二进制数据的缺点的。
其次，Buffer是node.js众多解决方案中一个。
再次，Buffer是一个内存缓冲区。
最后，Buffer实例的长度在创建时就定下了，不可改变。
Buffer实例有多种创建方法
- buffer-create.js:
var buf1 = new Buffer('abcdefghijklmnopqrstuvwxyz');
console.log('method1:'+buf1.toString());
var buf2 = new Buffer([97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122]);
console.log('method2:'+buf2.toString());
var buf3 = new Buffer(26);
buf3.write('abcdefghijklmnopqrstuvwxyz');
console.log('method3:'+buf3.toString());
var buf4 = new Buffer(buf1);
console.log('method4:'+buf4.toString());- 运行效果如下：
lee@mypc ~/works/nodejs/study10 $ node buffer-create.js
method1:abcdefghijklmnopqrstuvwxyz
method2:abcdefghijklmnopqrstuvwxyz
method3:abcdefghijklmnopqrstuvwxyz
method4:abcdefghijklmnopqrstuvwxyzBuffer的写入
- buffer-write.js:
var buf1 = new Buffer('abcdefghijklmnopqrstuvwxyz');
console.log('Before write:'+buf1.toString());
var len = buf1.write('123456789', 20);
console.log('Before write:'+buf1.toString());
console.log('Write length:'+len);- 运行效果如下：
lee@mypc ~/works/nodejs/study10 $ node buffer-write.js
Before write:abcdefghijklmnopqrstuvwxyz
Before write:abcdefghijklmnopqrst123456
Write length:6- 分析：
上例中，我们试图写入‘123456789’这9个数字，但最终只写入了‘123456’这6个数字，这也说明了Buffer实例的长度不可改变这一特性。
buf.toJSON
- node.js的文档:
buf.toJSON()
Returns a JSON representation of the Buffer instance. JSON.stringify implicitly calls this function when stringifying a Buffer instance.
- buffer-json.js:
var buf1 = new Buffer('abcdefghijklmnopqrstuvwxyz');
console.log(buf1.toJSON());
var json = JSON.stringify(buf1)
console.log(JSON.parse(json));- 运行结果，两次打印一模一样：
lee@mypc ~/works/nodejs/study10 $ node buffer-json.js
{ type: 'Buffer',
data:
[ 97,
98,
99,
100,
101,
102,
103,
104,
105,
106,
107,
108,
109,
110,
111,
112,
113,
114,
115,
116,
117,
118,
119,
120,
121,
122 ] }
{ type: 'Buffer',
data:
[ 97,
98,
99,
100,
101,
102,
103,
104,
105,
106,
107,
108,
109,
110,
111,
112,
113,
114,
115,
116,
117,
118,
119,
120,
121,
122 ] }buffer合并
- 语法
Buffer.concat(list[,totalLength])
list - 用于合并的 Buffer 对象数组列表。
totalLength - 指定合并后Buffer对象的总长度。
- 先来举个栗子，buffer-concat.js
var buf1 = new Buffer('abc');
var buf2 = new Buffer('1234');
var newbuf = Buffer.concat([buf1, buf2]);
console.log(newbuf.toString());- 运行效果如下：
lee@mypc ~/works/nodejs/study10 $ node buffer-concat.js
abc1234- 分析：
上例中的代码，实现了两个Buffer实例的合并。
但是根据Buffer实例的长度不可变的特性，它是如何做到的？不妨看一下concat的源码：
Buffer.concat = function(list, length) {
if (!Array.isArray(list))
throw new TypeError('list argument must be an Array of Buffers.');
if (list.length === 0)
return new Buffer(0);
if (length === undefined) {
length = 0;
for (var i = 0; i < list.length; i++)
length += list[i].length;
} else {
length = length >>> 0;
}
var buffer = new Buffer(length);
var pos = 0;
for (var i = 0; i < list.length; i++) {
var buf = list[i];
buf.copy(buffer, pos);
pos += buf.length;
}
return buffer;
};从源码中可以看到，所谓的concat其实也就是重新定一个Buffer实例，然后把源Buffer实例copy进去。
byteLength
Buffer.byteLength(string[, encoding])返回string的byte length, 它和string.length并不相同。
- 举个栗子先，buffer-bytelength.js：
str = '\u00bd + \u00bc = \u00be';
console.log(str + ": " + str.length + " characters, " +
Buffer.byteLength(str, 'utf8') + " bytes");- 运行结果如下：
lee@mypc ~/works/nodejs/study10 $ node buffer-bytelength.js
½ + ¼ = ¾: 9 characters, 12 bytes