方法說明:
寫入文件(根據文件描述符),功能與 fs.writeFile() 類似,但該方法提供更底層的操作,實際應用中建議使用多 fs.writeFile() 。
該方法有兩種形式:
1、fs.write(fd, buffer, offset, length[, position], [callback(err, bytesWritten, buffer)])
這種寫法將buffer寫入文件(根據文件描述符fd來查找文件)。
2、fs.write(fd, data[, position[, encoding]], [callback(err, written, string)])
這種寫法將數據data寫入文件(根據文件描述符fd來查找文件)。如果數據不是一個緩沖區的實例值將被強制轉換為一個字符串。
語法:
代碼如下:
fs.write(fd, buffer, offset, length[, position], [callback(err, bytesWritten, buffer)])
fs.write(fd, data[, position[, encoding]], [callback(err, written, string)])
由於該方法屬於fs模塊,使用前需要引入fs模塊(var fs= require(“fs”) )
接收參數:
fd 文件描述符。
buffer 緩沖區,數據將被寫入。buffer尺寸的大小設置最好是8的倍數,效率較高。
offset buffer寫入的偏移量
length (integer) 指定文件讀取字節數長度
position (integer) 指定文件讀取的起始位置,如果該項為null,將從當前文件指針的位置開始讀取數據。
callback 回調傳遞了三個參數,err, bytesRead, buffer
· err 異常
· bytesRead:讀取的字節數
· buffer:緩沖區對象
第二種形式:
encoding 字符編碼
callback
· err 異常
· written 指定多少字符數將被寫入到文件。
· string 返回的Buffer
例子:
代碼如下:
//fs.write(fd, buffer, offset, length[, position], [callback(err, bytesWritten, buffer)])
//執行結果:bytesWritten = 8 , buffer = <Buffer 00 00 00 01 00 00 00 00>
var fs = require('fs');
fs.open('content.txt', 'a', function(err,fd){
if(err){
throw err;
}
var data = '123123123 hello world';
var buf = new Buffer(8);
fs.write(fd, buf, 0, 8, 0, function(err, bytesWritten, buffer){
if(err){
throw err;
}
console.log(bytesWritten);
console.log(buffer);
fs.close(fd,function(err){
if(err){
throw err;
}
console.log('file closed');
})
})
})
//fs.write(fd, data[, position[, encoding]], [callback(err, written, string)])
//執行結果:written = 21 , string = <Buffer 31 32 33 31 32 33 31 32 33 20 68 65 6c 6c 6f 20 77 bf 72 6c 64>
var fs = require('fs');
fs.open('content.txt', 'a', function(err,fd){
if(err){
throw err;
}
var data = '123123123 hello world';
fs.write(fd, data, 0 , 'utf-8', function(err, written, string){
if(err){
throw err;
}
console.log(written);
console.log(string);
fs.close(fd,function(err){
if(err){
throw err;
}
console.log('file closed');
})
})
})
源碼:
代碼如下:
// usage:
// fs.write(fd, buffer, offset, length[, position], callback);
// OR
// fs.write(fd, string[, position[, encoding]], callback);
fs.write = function(fd, buffer, offset, length, position, callback) {
if (util.isBuffer(buffer)) {
// if no position is passed then assume null
if (util.isFunction(position)) {
callback = position;
position = null;
}
callback = maybeCallback(callback);
var wrapper = function(err, written) {
// Retain a reference to buffer so that it can't be GC'ed too soon.
callback(err, written || 0, buffer);
};
return binding.writeBuffer(fd, buffer, offset, length, position, wrapper);
}
if (util.isString(buffer))
buffer += '';
if (!util.isFunction(position)) {
if (util.isFunction(offset)) {
position = offset;
offset = null;
} else {
position = length;
}
length = 'utf8';
}
callback = maybeCallback(position);
position = function(err, written) {
// retain reference to string in case it's external
callback(err, written || 0, buffer);
};
return binding.writeString(fd, buffer, offset, length, position);
};