文件系统fs
fs模块是文件操作的封装,它提供了文件读取、写入、更名、删除、遍历目录、链接等POSIX文件系统操作。与其它模块不同的是,fs模块中所有的操作都提供了异步的和同步的两个版本。
fs.readFile
fs.readFile(filename,[encoding],[callback(error,data)]是最简单的文件读取函数,它接受一个必选参数filename,表示读取的文件名,第二个参数encoding是可选的,表示文件字符编码。callback是回调函数,用于接收文件的内容。如果不指定encoding,则callback就是第二个参数。回调函数提供两个参数err和data,err表示有没有错误发生,data是文件内容。如果指定encoding,data是一个解析后的字符串,否则将会以Buffer形式表示的二进制数据。
var fs = require(‘rs’);
fs.readFile(‘content.text’,function(err,data){
if(err){
console.log(err);
}else{
console.log(data);
}
});
var fs = require(‘rs’);
fs.readFile(‘content.text’,’utf-8’,function(err,data){
if(err){
console.log(err);
}else{
console.log(data);
}
});
fs.readFileSync
fs.readFileSync(filename,[encoding])是fs.readFile同步的版本。它接受的参数和fs.readFile相同,而读取的文件内容以函数返回值的形式返回。如果有错误发生,fs将会抛出异常。需要try….catch
fs.open
fs.opne(path,flags,[mode],[callback(err,fd)])是POSIX open函数的封装,与c语言标准库中的fopen函数类似。它接受两个必选参数,path为文件的路径,flags可以是以下值
l r:以读取模式打开文件
l r+:以读写模式
l w:以写入模式打开,如果不存在则创建
l w+:以读写模式打开,如果不存在则创建
l a:以追加模式打开文件,如果不存在则创建
l a+:以读取追加模式打开文件,如果文件不存在则创建。
mode参数用于创建文件时给文件指定权限,默认是0666(八进制数,如0754 写成字符串:-rwxr-xr--)
fs.read
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,分别表示读取的字节数和缓冲区对象。
示例:
var fs = require(‘fs’);
fs.open(‘content.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);
});
});
一般来说,除非必要,否则不要使用这种方式读取文件,因为它要求你手动管理缓冲区和文件指针,尤其是在你不知道文件大小的时候,这将会是一个很麻烦的事情。