方法說明:
根據指定的檔案描述子fd來讀取檔案資料並寫入buffer所指向的緩衝區物件。相對於readFile提供了更底層的介面。
一般情況下不建議使用這種方式來讀取文件,因為它要求你手動管理緩衝區和文件指針,尤其是在你不知道文件大小的時候,這將會是一件很麻煩的事情。
文法:
fs.read(fd,buffer,offset,length,position,[callback(err,bytesRead,buffer)])
由於方法屬於fs模組,使用前需要引入fs模組(var fs= require(“fs”) )
接收參數:
fs 檔案描述子
buffer 緩衝區,資料將會寫入。
offset buffer寫入的偏移
length (integer) 指定檔案讀取位元組數長度
position (integer) 指定檔案讀取的起始位置,如果該項目為null,則將從目前檔案指標的位置開始讀取資料。
callback 回呼傳遞了三個參數,err, bytesRead, buffer
· err 異常
· bytesRead:讀取的位元組數
· buffer:緩衝區物件
範例:
var fs = require('fs');
fs.open('123.txt' , 'r' , function (err,fd){
if(err){
console.error(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);
})
})
原始碼:
fs.read = function(fd, buffer, offset, length, position, callback) {
if (!util.isBuffer(buffer)) {
// legacy string interface (fd, length, position, encoding, callback)
var cb = arguments[4],
encoding = arguments[3];
assertEncoding(encoding);
position = arguments[2];
length = arguments[1];
buffer = new Buffer(length);
offset = 0;
callback = function(err, bytesRead) {
if (!cb) return;
var str = (bytesRead > 0) ? buffer.toString(encoding, 0, bytesRead) : '';
(cb)(err, str, bytesRead);
};
}
function wrapper(err, bytesRead) {
// Retain a reference to buffer so that it can't be GC'ed too soon.
callback && callback(err, bytesRead || 0, buffer);
}
binding.read(fd, buffer, offset, length, position, wrapper);
};