前一篇學習了文件的打開和關(guān)閉,文件操作總不能只包含打開和關(guān)閉吧,這里就開始文件的讀寫操作。
fs模塊方法
1:read和readSync方法
該方法,是從文件的指定位置處讀取文件,一直讀取到文件底部,然后江都區(qū)到的內(nèi)容輸出到一個緩存區(qū),使用方法如下:
fs.read(fd,buffer,offset,length,position,callback);
在read方法中,支持6個參數(shù):
function (err,bytesRead,buffer){ //err為讀取文件操作失敗時,觸發(fā)的錯誤對象 //bytesRead為讀取到的字節(jié)數(shù),如果文件的比較大,則該值就是length的值, //如果文件的大小比length小,則該值為實際中讀取到的字節(jié)數(shù)。 //buffer為讀取到的內(nèi)容,保存到了該緩存區(qū),如果在使用read時, //傳入了buffer對象,則此處的buffer就是傳入的buffer對象。 //如果在read時沒有傳入buffer,則此處的buffer為新創(chuàng)建的buffer對象 }
上面把參數(shù)的含義以及回調(diào)函數(shù)的定義,都說明了一下,這里就看一個示例吧:
var fs = require("fs"); fs.open("fs.txt","r",function(err,fd){ //讀取fs.text,文件的內(nèi)容為“123456789”,長度為9 var buffer = new Buffer([0,0,0,0,0,0,0,0,0,0]); //創(chuàng)建一個長度為10,初始值為0的buffer對象。 //數(shù)據(jù)比較少,就直接寫了,否則還是使用fill方法吧。 console.log(buffer); //<Buffer 00 00 00 00 00 00 00 00 00 00> //初始時的buffer對象 fs.read(fd,buffer,4,6,4,function(err,bytesRead,buffer1){ //讀取到的數(shù)據(jù),從buffer對象的第5個元素開始保存,保存6個字節(jié)的元素 //讀取文件,是從文件的第5個字節(jié)開始,因為文件中內(nèi)容長度為9, //那么,讀取到的內(nèi)容就是56789,所以buffer的最后一位仍然為初始值。 //由于想要讀取的字節(jié)長度為6,但是文件內(nèi)容過短,只讀取了5個字節(jié)的有效數(shù)據(jù) //就到了文件的結(jié)尾了,所以,bytesRead的值不是6,而是5。 //而buffer對象,為被寫入新數(shù)據(jù)之后的對象。 console.log(bytesRead); //5 console.log(buffer1); //<Buffer 00 00 00 00 35 36 37 38 39 00> console.log(buffer); //<Buffer 00 00 00 00 35 36 37 38 39 00> //它們倆是完全相同的。其實質(zhì)是,它們倆占據(jù)的內(nèi)存也是相同的, //它們就是同一個緩存區(qū)。 }); });
一般情況下,異步調(diào)用時,回調(diào)函數(shù)中,只有兩個參數(shù)存在,第一個參數(shù)為err對象,第二個參數(shù)為操作之后的數(shù)據(jù),可是,這里有三個數(shù)據(jù),那么在同步時,什么才是返回值呢?
所以,要做如下的測試:
var fs = require("fs"); fs.open("fs.txt","r",function(err,fd){ //讀取fs.text,文件的內(nèi)容為“123456789”,長度為9 var buffer = new Buffer([0,0,0,0,0,0,0,0,0,0]); var bytesRead = fs.readSync(fd,buffer,4,6,4); console.log(bytesRead); });
返回的是bytesRead的值,并沒有返回buffer對象,可以想象,因為buffer對象是原本傳入的buffer對象,依然可以通過傳入的buffer對象,直接訪問到重寫數(shù)據(jù)之后的buffer對象。
但是,有個問題就來了,如果沒有傳入buffer對象呢?這又要如何呢?這個問題暫且別過,因為這個問題,并沒有在一些API文檔中說明,在書中也沒有看到這個用法,但是接下來,我們?nèi)シ治鲆幌略创a,就能發(fā)現(xiàn),除了上述的兩種常用的方法之外,還有其他的使用方式。
OK,先看下read方法的源碼:
fs.read = function(fd, buffer, offset, length, position, callback) { if (!util.isBuffer(buffer)) { //如果傳入的第二個參數(shù)不是一個buffer對象,則做一些自適應(yīng)的處理 // legacy string interface (fd, length, position, encoding, callback) var cb = arguments[4], encoding = arguments[3]; //本來read方法是有6個參數(shù)的,當buffer沒有傳入的時候, //則相應(yīng)的offset也變得沒有意義,所以變?yōu)榱?個參數(shù)。 //而這個時候,參數(shù)的形式就變成了前面英文部分的樣子。5個參數(shù),加入了encoding參數(shù)。 assertEncoding(encoding); //判斷傳入的encoding是否是當前支持的編碼方式 //如果不是,則拋出異常 position = arguments[2]; length = arguments[1]; buffer = new Buffer(length); offset = 0; //設(shè)置對應(yīng)的值,新建buffer對象 //把callback做一個代理,根據(jù)傳入的編碼方式,把結(jié)果按照指定的編碼,傳入回調(diào)函數(shù) callback = function(err, bytesRead) { if (!cb) return; //如果回調(diào)函數(shù)不存在,則直接退出 var str = (bytesRead > 0) ? buffer.toString(encoding, 0, bytesRead) : ''; //注意,當讀取文件成功后,執(zhí)行了wrapper的回調(diào),從wrapper中, //執(zhí)行到該callback回調(diào)時,并沒有傳入buffer對象, //并且,調(diào)用read中的回調(diào)的三個參數(shù)是:err,str(按照指定編碼之后的字符串), //bytesRead(讀取字節(jié)數(shù)),并沒有buffer對象傳入 (cb)(err, str, bytesRead); }; } function wrapper(err, bytesRead) { // Retain a reference to buffer so that it can't be GC'ed too soon. // 由這里可以看出,在C++讀取文件時,回調(diào)函數(shù)只有兩個值 //err對象和真實讀取的字節(jié)數(shù),至于buffer對象,則是nodejs代理之后 //給添加上的 callback && callback(err, bytesRead || 0, buffer); } //創(chuàng)建一個實例,定義oncomplete屬性 //該實例,按照猜測,應(yīng)該是分段讀取文件的一個對象 //當讀取文件完成之后,會執(zhí)行oncomplete方法 var req = new FSReqWrap(); req.oncomplete = wrapper; //調(diào)用C++的接口,開始讀取文件 binding.read(fd, buffer, offset, length, position, req); };
看了上面的源碼分析,那么也就發(fā)現(xiàn)了另外一種使用read的方法了,即,不輸入buffer和offset,添加encoding的5個參數(shù)的使用,舉一個最簡單的實例吧。
var fs = require("fs"); fs.open("fs.txt","r",function(err,fd){ //讀取fs.text,文件的內(nèi)容為“123456789”,長度為9 var buf1 = new Buffer([0,0,0,0,0,0,0,0,0,0]); fs.read(fd,6,4,null,function(err,str,bytesRead){ console.log(err); //null console.log("str="+str); //str=56789 console.log("bytesRead="+bytesRead); //bytesRead=5 }); });
注意,當不傳入buffer對象時,回調(diào)函數(shù)中的三個參數(shù)也相應(yīng)的有了變化,詳情請看前面的實例代碼中,回調(diào)函數(shù)的參數(shù)以及源碼中的注釋。
繼續(xù)看下readSync的源碼,在本文的前面,也給出了一個readSync的示例,當傳入buffer對象時,返回值是讀取到真是字節(jié)數(shù),那么,既然read方法可以省略buffer對象,改為返回讀取到的字符串,那么readSync方法呢?這個就讓我們看下源碼中,是如何處理這些數(shù)據(jù)的。
fs.readSync = function(fd, buffer, offset, length, position) { var legacy = false; if (!util.isBuffer(buffer)) { // legacy string interface (fd, length, position, encoding, callback) //該部分的處理,和read方法內(nèi)部,完全相同,不再注釋。 //唯一區(qū)別,legacy標識符,標志是否傳入了buffer,為false時,表示傳入了 legacy = true; var encoding = arguments[3]; assertEncoding(encoding); position = arguments[2]; length = arguments[1]; buffer = new Buffer(length); offset = 0; } //C++的read方法,如果傳入了第六個參數(shù),則屬于讀取成功之后,執(zhí)行的回調(diào)相關(guān)的對象 //如果不傳入,則返回值為讀取到的真是字節(jié)數(shù),該數(shù)小于等于length var r = binding.read(fd, buffer, offset, length, position); if (!legacy) { //如果,傳入了buffer對象,則直接返回讀取到的真是字節(jié)數(shù) return r; } var str = (r > 0) ? buffer.toString(encoding, 0, r) : ''; //如果沒有傳入buffer對象,那么返回一個數(shù)組,該數(shù)組包含兩個元素, //字符串和讀取到的字節(jié)數(shù) return [str, r]; };
那么接下來看下,如果不傳入buffer對象時的一個示例吧:
var fs = require("fs"); fs.open("fs.txt","r",function(err,fd){ //讀取fs.text,文件的內(nèi)容為“123456789”,長度為9 var buf1 = new Buffer([0,0,0,0,0,0,0,0,0,0]); var arr = fs.readSync(fd,6,4,null); console.log(arr); //["56789",5] });
OK,到這里,關(guān)于read和readSync方法的使用及一些原理性東西,也基本說完了。
2:write和writeSync方法
有讀取的方法,那么就必然有寫入的方法了,要么flag=w不就無用了么。并且看到了前面的關(guān)于read的一些使用,那么接下來,對于write的使用,看起來就變得更加的簡單了,現(xiàn)在直接看下示例:
var fs = require("fs"); fs.open("fs.txt","a+",function(err,fd){ //讀取fs.text,文件的內(nèi)容為“123456789”,長度為9 var buf1 = new Buffer("我喜愛Nodejs"); console.log(buf1); //顯示buf1的buffer數(shù)據(jù) //計算buf1的長度,把該數(shù)據(jù)全部寫入到fs.txt文件中 fs.write(fd,buf1,0,buf1.length,0,function(err,len,buf){ console.log("len="+len); //寫入的長度 //寫入的buf,其實和buf1完全相等 console.log(buf); fs.read(fd,len,9,"utf8",function(err,str,len2){ console.log("len2="+len2); //讀取從9開始的數(shù)據(jù) console.log("str="+str); //讀取相應(yīng)得到的字符串 //我喜愛Nodejs }); }); });
從上面這個示例可以看出,write方法和read方法,使用基本是完全一樣的,只是一個是在讀取文件一個是在寫入文件,前提也是需要你在open打開文件時,使用的flag打開文件方式,要支持讀寫才行。
既然,write和read是相同的使用方法,那么也可以不定義buffer的直接寫入數(shù)據(jù),所以,可以繼續(xù)看下面的這個示例:
var fs = require("fs"); fs.open("fs.txt","a+",function(err,fd){ //讀取fs.text,文件的內(nèi)容為“123456789”,長度為9 //復雜的寫法,和簡單的寫法,就看個人喜好了,0代表的是字符串的開始位置 //fs.write(fd,"我喜愛Nodejs",0,"utf8",function(err,len,str) fs.write(fd,"我喜愛Nodejs",function(err,len,str){ console.log("len="+len); //len=15 //寫入的長度 //當直接寫入字符串時,返回的也不再是buffer對象,而是字符串 console.log("str="+str); //我喜愛Nodejs fs.read(fd,len,9,"utf8",function(err,str,len2){ console.log("len2="+len2); //len2=15 //讀取從9開始的數(shù)據(jù) console.log("str="+str); //讀取相應(yīng)得到的字符串 //我喜愛Nodejs }); }); });
這里就不再分析源碼了,基本上write的源碼和read的源碼處理方式類似,只是在最后調(diào)用C++接口不同而已,所以這里也就不再占用空間了。有興趣的可以直接去nodejs的github源碼中,查看:fs.js。
關(guān)于writeSync的用法,用法和write是相同的,只是不需要回調(diào)函數(shù),并且也不需要返回寫入的數(shù)據(jù),所以,和readSync的區(qū)別,也就是,readSync在不傳入buffer時,會返回一個長度為2的數(shù)組,而writeSync不受buffer對象的影響,只要寫入成功,就會返回寫入的真實字節(jié)數(shù)。
不加示例,不加源碼分析,請參考上面的read方法,readSync方法和write方法,也可以參考nodejs的API文檔:Nodejs的API中文版。
總結(jié)
本篇的read和write是文檔操作的基礎(chǔ),是屬于最基本的操作,也是最重要的操作,本篇也是屬于fs模塊中的基本使用方法,對于以后學習其他方法,以及更好的了解fs模塊有重要的作用,好好學習,天天向上。
以上就是本文的全部內(nèi)容,希望對大家的學習有所幫助,也希望大家多多支持武林網(wǎng)。
新聞熱點
疑難解答