Node.js 文件系统 fs
来源:互联网 发布:关于阿国网络随笔 编辑:程序博客网 时间:2024/05/16 08:34
文件系统 fs
fs 模块是文件操作的封装,它提供了文件的读取、写入、更名、删除、遍历目录、链接等 POSIX 文件系统操作。与其他模块不同的是,fs模块中所有的操作都提供了异步的和同步的两个版本,例如读取文件内容的函数有异步的 fs.readFile() 和同步的 fs.readFileSync()。我们以几个函数为代表,介绍fs常用的功能,并列出 fs 所有函数 的定义和功能。
fs.readFile
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.log(err); }else{ console.log(data); }});
假设 content.txt 中的内容是 UTF-8 编码的 Text 文本文件示例,运行结果如下:
这个程序以二进制的模式读取了文件的内容,data 的值是 Buffer 对象。如果我们给 fs.readFile 的 encoding 指定编码:
var fs = require("fs");fs.readFile('content.txt','utf-8',function(err,data){ if(err){ console.log(err); }else{ console.log(data); }});
当读取文件出现错误时,err 将会是 Error 对象。如果 content.txt 不存在,运行前面 的代码则会出现以下结果:
注意:Node.js 的异步编程接口习惯是以函数的后一个参数为回调函数,通 常一个函数只有一个回调函数。回调函数是实际参数中第一个是 err,其 余的参数是其他返回的内容。如果没有发生错误,err 的值会是 null 或 undefined。如果有错误发生,err 通常是 Error 对象的实例。
fs.readFileSync
fs.readFileSync(filename, [encoding])是 fs.readFile 同步的版本。它接受 的参数和 fs.readFile 相同,而读取到的文件内容会以函数返回值的形式返回。如果有错 误发生,fs 将会抛出异常,你需要使用 try 和 catch 捕捉并处理异常。
fs.open
fs.open(path, flags, [mode], [callback(err, fd)])是 POSIX open 函数的 封装,与 C 语言标准库中的 fopen 函数类似。它接受两个必选参数,path 为文件的路径, flags 可以是以下值。
- r :以读取模式打开文件。
- r+ :以读写模式打开文件。
- w :以写入模式打开文件,如果文件不存在则创建。
- w+ :以读写模式打开文件,如果文件不存在则创建。
- a :以追加模式打开文件,如果文件不存在则创建。
- a+ :以读取追加模式打开文件,如果文件不存在则创建。
mode 参数用于创建文件时给文件指定权限,默认是 0666。回调函数将会传递一个文件描述符 fd。
文件权限指的是 POSIX 操作系统中对文件读取和访问权限的规范,通常用一个八进制数来表示。例如 0754 表 示文件所有者的权限是 7 (读、写、执行),同组的用户权限是 5 (读、执行),其他用户的权限是 4 (读), 写成字符表示就是 -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,分别表示读取的字节数和缓冲区对象。
以下是一个使用 fs.open 和 fs.read 的示例
var fs = require('fs');fs.open('content.txt','r',function(err,fd){ if(err){ console.err(err); return ; } var buf = new Buffer(8); fs.read(fd,buf,0,8,null,function(err,bytesRead,buffer){ if(err){ console.err(err); return ; } console.log('bytesRead: ' + bytesRead); console.log(buffer); });});
运行结果:
一般来说,除非必要,否则不要使用这种方式读取文件,因为它要求你手动管理缓冲区 和文件指针,尤其是在你不知道文件大小的时候,这将会是一件很麻烦的事情。
下面列出了fs所有函数的定义和功能:
更多使用详情可以参考:http://www.runoob.com/nodejs/nodejs-fs.html
- Node.js文件系统fs
- Node.js 文件系统 fs
- Node.js中的文件系统(FS)
- Node.js学习(10)----文件系统fs
- node.js之基本文件系统模块fs
- 【Node文件系统fs模块】
- Node.js基本模块 fs(是文件系统模块)
- Node.js内置的文件系统模块(fs)
- Node.js中的fs文件系统--目录相关方法;
- Node.js中fs文件系统-与文件file相关;
- Node.js fs.Stats
- Node.js fs 模块
- node.js fs文件 操作
- node.js中的fs模块
- Node.js中的fs.open、fs.read、fs.write、fs.close方法;
- Node.Js API 解析--FS模块
- Node.js编程时fs.renameSync出错
- Node.js学习--基础知识(7)--fs
- PowerDesigner连接数据库,PowerDesigner将数据同步到数据库,PowerDesigner和数据库中的表进行比对
- 用QT写一个华科宿舍电费查询程序
- linux常用命令学习--笔记
- poi报表导出
- 1005. Spell It Right (20)
- Node.js 文件系统 fs
- HDU 2017 字符串统计
- 总结http服务器框架
- java实现url访问(get,post)
- 常见问题总结
- 01.spring_helloword
- codevs 1173 最优贸易
- Android第五天之ProgressBar进度条
- Caffe实战Day4-开始模型训练