node.js模块之fs文件系统

fs 模块是文件操作的封装，它提供了文件的读取、写入、更名、删除、遍历目录、链接等 POSIX 文件系统操作。与其他模块不同的是，fs 模块中所有的操作都提供了异步的和同步的两个版本， 例如读取文件内容的函数有异步的 fs.readFile() 和同步的fs.readFileSync()。我们以几个函数为代表，介绍 fs 常用的功能，并列出 fs 所有函数的定义和功能。

fs.readFile(filename,[encoding],[callback(err,data)])是最简单的读取文件的函数。它接受一个必选参数 filename，表示要读取的文件名。第二个参数 encoding是可选的，表示文件的字符编码。callback 是回调函数，用于接收文件的内容。如果不指定 encoding，则 callback 就是第二个参数。回调函数提供两个参数 err 和 data，err 表示有没有错误发生，data 是文件内容。如果指定了 encoding，data 是一个解析后的字符串，否则 data 将会是以 Buffer 形式表示的二进制数据。例如以下程序，我们从 content.txt 中读取数据，但不指定编码：

var fs = require('fs');
fs.readFile('content.txt', function(err, data) {
if (err) {
console.error(err);
} else {
console.log(data);
}
});
假设 content.txt 中的内容是 UTF-8 编码的 Text 文本文件示例，运行结果如下：
<Buffer 54 65 78 74 20 e6 96 87 e6 9c ac e6 96 87 e4 bb b6 e7 a4 ba e4 be 8b>
这个程序以二进制的模式读取了文件的内容，data 的值是 Buffer 对象。如果我们给
fs.readFile 的 encoding 指定编码：

var fs = require('fs');
fs.readFile('content.txt', 'utf-8', function(err, data) {
if (err) {
console.error(err);
} else {
console.log(data);
}
});
那么运行结果则是：
Text 文本文件示例

Node.js 的异步编程接口习惯是以函数的最后一个参数为回调函数，通
常一个函数只有一个回调函数。回调函数是实际参数中第一个是 err，其
余的参数是其他返回的内容。如果没有发生错误，err 的值会是 null 或
undefined。如果有错误发生，err 通常是 Error 对象的实例。

fs.readFileSync(filename, [encoding])是 fs.readFile 同步的版本。它接受
的参数和 fs.readFile 相同，而读取到的文件内容会以函数返回值的形式返回。如果有错
误发生，fs 将会抛出异常，你需要使用 try 和 catch 捕捉并处理异常。

与同步 I/O 函数不同，Node.js 中异步函数大多没有返回值。

fs.open(path, flags, [mode], [callback(err, fd)])是 POSIX open 函数的
封装，与 C 语言标准库中的 fopen 函数类似。它接受两个必选参数，path 为文件的路径，
flags 可以是以下值。
 r ：以读取模式打开文件。
 r+ ：以读写模式打开文件。
 w ：以写入模式打开文件，如果文件不存在则创建。
 w+ ：以读写模式打开文件，如果文件不存在则创建。
 a ：以追加模式打开文件，如果文件不存在则创建。
 a+ ：以读取追加模式打开文件，如果文件不存在则创建。
mode 参数用于创建文件时给文件指定权限，默认是 0666①。回调函数将会传递一个文
件描述符 fd②。

fs.read(fd, buffer, offset, length, position, [callback(err, bytesRead,buffer)])是 POSIX read 函数的封装，相比 fs.readFile 提供了更底层的接口。fs.read的功能是从指定的文件描述符 fd 中读取数据并写入 buffer 指向的缓冲区对象。offset 是buffer 的写入偏移量。length 是要从文件中读取的字节数。position 是文件读取的起始位置，如果 position 的值为 null，则会从当前文件指针的位置读取。回调函数传递bytesRead 和 buffer，分别表示读取的字节数和缓冲区对象。以下是一个使用 fs.open 和 fs.read 的示例。

var fs=require("fs");
fs.open("data.txt","r",function(err,fd){
    if(err)
    {
        console.log(err);
        return;
    }

    var buf=new Buffer(8);
    fs.read(fd,buf,0,8,null,function(err,bytesRead,buffer){
        if(err)
        {
            console.log(err);
            return;
        }
        console.log("bytesRead:"+bytesRead);
        console.log(buffer);

    })

})

一般来说，除非必要，否则不要使用这种方式读取文件，因为它要求你手动管理缓冲区
和文件指针，尤其是在你不知道文件大小的时候，这将会是一件很麻烦的事情。