DIV CSS 佈局教程網

Node.js 中的 fs.readSync 方法詳解
編輯:關於JavaScript     

方法說明

同步版本的 fs.read(),從檔案描述符讀取資料並寫入緩衝區,回傳值為實際讀取到的位元組數 bytesRead。

語法

fs.readSync(fd, buffer, offset, length, position)

屬於 fs 模塊,使用前先引入:

var fs = require("fs");

參數說明

  • fd:檔案描述符,由 fs.open() 取得。
  • buffer:資料將被寫入的緩衝區。
  • offset:在 buffer 中的寫入偏移量。
  • length:本次要讀取的位元組數。
  • position:檔案中的讀取起始位置。若為 null,則從當前檔案指針位置開始讀取。

使用範例

var fs = require('fs');
fs.open('123.txt', 'r', function (err, fd) {
  if (err) {
    console.error(err);
    return;
  }
  var buf = new Buffer(8);
  var readfile = fs.readSync(fd, buf, 0, 8, null);
  console.log(readfile);
});

源碼解析

fs.readSync = function(fd, buffer, offset, length, position) {
  var legacy = false;
  if (!util.isBuffer(buffer)) {
    // 舊版字串介面 (fd, length, position, encoding, callback)
    legacy = true;
    var encoding = arguments[3];
    assertEncoding(encoding);
    position = arguments[2];
    length = arguments[1];
    buffer = new Buffer(length);
    offset = 0;
  }
  var r = binding.read(fd, buffer, offset, length, position);
  if (!legacy) {
    return r;
  }
  var str = (r > 0) ? buffer.toString(encoding, 0, r) : '';
  return [str, r];
};

源碼裡最值得注意的一段是開頭的相容性處理:如果第一個參數傳進來的不是 Buffer,就判定為使用了早期那種「fd、length、position、encoding」的字串介面,此時函式會自行建立緩衝區,最後把內容轉成字串,並以 [字串, 位元組數] 的形式回傳。新版介面則一律回傳位元組數。

實務提醒

範例中的 new Buffer(8) 已屬不建議使用的寫法,請改用 Buffer.alloc(8);若要從既有資料建立,則用 Buffer.from()。另外,同步 API 會阻塞事件迴圈,在伺服器請求路徑上大量使用會直接拖累吞吐量,適合用在啟動階段讀取設定檔這類一次性場景。真正的高併發讀檔,還是以 fs.read() 或 createReadStream() 為宜。最後别忘了,用完檔案描述符要呼叫 fs.close()(或 fs.closeSync())釋放,否則檔案描述符遲早會耗盡。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved