方法說明
用來修改檔案名稱,同時也可以用來變更檔案的存放位置,等於一次完成「改名」與「移動」兩個動作。
語法
fs.rename(oldPath, newPath, [callback(err)])
此方式屬於 fs 模組,使用前必須先引入:var fs = require("fs")
參數說明
oldPath:原路徑。
newPath:新路徑。
callback:回調函式,接收一個 err 異常參數。
範例
同目錄下單純改名:
var fs = require('fs');
fs.rename('125.txt', '126.txt', function(err){
if (err) {
throw err;
}
console.log('done!');
});
跨路徑改名並移動(新的目標目錄必須已存在,否則會回傳異常):
var fs = require('fs');
fs.rename('125.txt', 'new/126.txt', function(err){
if (err) {
throw err;
}
console.log('done!');
});
原始碼
fs.rename = function(oldPath, newPath, callback) {
callback = makeCallback(callback);
if (!nullCheck(oldPath, callback)) return;
if (!nullCheck(newPath, callback)) return;
binding.rename(pathModule._makeLong(oldPath),
pathModule._makeLong(newPath),
callback);
};