Buffer
JavaScript 语言自身只有字符串数据类型,没有二进制数据类型。但在处理像TCP流或文件流时,必须使用到二进制数据。因此Buffer类用来创建一个专门存放二进制数据的缓存区。一个 Buffer 类似于一个整数数组,但它对应于 V8 堆内存之外的一块原始内存。
创建Buffer类
通过new Buffer(arg)来创建实例。
arg可以是长度、数组或者字符串:
var buf = new Buffer(10);
var buf = new Buffer([10, 20, 30, 40, 50]);
var buf = new Buffer("helloworld", "utf-8");
utf-8 是默认的编码方式,此外它同样支持以下编码:”ascii”, “utf8”, “utf16le”, “ucs2”, “base64” 和 “hex”。
写入缓冲区
- write方法
write(string[, offset[, length]][, encoding])
- string - 写入缓冲区的字符串
offset - 缓冲区开始写入的索引值,默认为 0
length - 写入的字节数,默认为 buffer.length
encoding - 使用的编码。默认为 ‘utf8’
返回值为实际写入的大小。
从缓冲区读取数据
- toString方法
toString([encoding[, start[, end]]])
- encoding - 使用的编码。默认为 ‘utf8’
start - 指定开始读取的索引位置,默认为 0
end - 结束位置,默认为缓冲区的末尾
返回值为使用指定的编码返回的字符串。
转换为JSON对象
- toJSON方法
var buf = new Buffer('helloWorld');
var json = buf.toJSON(buf);
console.log(json);
合并缓冲区
- concat方法
concat(list[, totalLength])
- list - 用于合并的 Buffer 对象数组列表
totalLength - 指定合并后Buffer对象的总长度
返回值为合并的新 Buffer 对象。
比较缓冲区
- compare方法
compare(otherBuffer)
- otherBuffer - 与 buf 对象比较的另外一个 Buffer 对象
返回值为一个数字,表示在 otherBuffer 之前,之后或相同。
var buffer1 = new Buffer('ABC');
var buffer2 = new Buffer('ABCD');
var result = buffer1.compare(buffer2);
if(result < 0) {
console.log(buffer1 + " 在 " + buffer2 + "之前");
}else if(result == 0){
console.log(buffer1 + " 与 " + buffer2 + "相同");
}else {
console.log(buffer1 + " 在 " + buffer2 + "之后");
}
拷贝缓冲区
- copy方法
copy(targetBuffer[, targetStart[, sourceStart[, sourceEnd]]])
- targetBuffer - 要拷贝的 Buffer 对象
targetStart - 数字, 可选, 默认: 0
sourceStart - 数字, 可选, 默认: 0
sourceEnd - 数字, 可选, 默认: buffer.length
剪裁缓冲区
- slice方法
- slice([start[, end]])
- start - 数字, 可选, 默认: 0
end - 数字, 可选, 默认: buffer.length
返回值为一个新的缓冲区,它和旧缓冲区指向同一块内存,但是从索引 start 到 end 的位置剪切。
更多方法查询手册
Stream
一个抽象接口。例如,对http 服务器发起请求的request 对象就是一个 Stream。
所有的 Stream 对象都是 EventEmitter 的实例。常用的事件有:
- data - 当有数据可读时触发。
- end - 没有更多的数据可读时触发。
- error - 在接收和写入过程中发生错误时触发。
- finish - 所有数据已被写入到底层系统时触发。
从流中读取数据
在input.txt中事先写入内容。
var fs = require("fs");
var data = '';
// 创建可读流
var readerStream = fs.createReadStream('input.txt');
// 设置编码为 utf8。
readerStream.setEncoding('UTF8');
// 处理流事件 --> data, end, and error
readerStream.on('data', function(chunk) {
data += chunk;
});
readerStream.on('end',function(){
console.log(data);
});
readerStream.on('error', function(err){
console.log(err.stack);
});
console.log("程序执行完毕");
向流中写入数据
var fs = require("fs");
var data = '1234567abcdefg';
// 创建一个可以写入的流,写入到文件 output.txt 中
var writerStream = fs.createWriteStream('output.txt');
// 使用 utf8 编码写入数据
writerStream.write(data,'UTF8');
// 标记文件末尾
writerStream.end();
// 处理流事件 --> data, end, and error
writerStream.on('finish', function() {
console.log("写入完成。");
});
writerStream.on('error', function(err){
console.log(err.stack);
});
console.log("程序执行完毕");
管道流
管道提供了一个输出流到输入流的机制。通常我们用于从一个流中获取数据并将数据传递到另一个流中。
var fs = require("fs");
// 创建一个可读流
var readerStream = fs.createReadStream('input.txt');
// 创建一个可写流
var writerStream = fs.createWriteStream('output.txt');
// 管道读写操作
// 读取 input.txt 文件内容,并将内容写入到 output.txt 文件中
readerStream.pipe(writerStream);
console.log("程序执行完毕");
链式流
链式是通过连接输出流到另外一个流并创建多个对个流操作链的机制。链式流一般用于管道操作。主要进行压缩和解压缩的操作。
自己加油加油 笨鸟后飞也要飞呀飞