Node.js 緩衝區

JavaScript 語言本身只有字串資料型，沒有二進位資料型別。

但在處理像TCP流或檔案流時，必須使用到二進位資料。因此在 Node.js中，定義了一個 Buffer 類，該類別用來建立一個專門存放二進位資料的快取區。

在 Node.js 中，Buffer 類別是隨 Node 核心一起發佈的核心函式庫。 Buffer 函式庫為Node.js 帶來了一種儲存原始資料的方法，可以讓Node.js 處理二進位數據，每當需要在Node.js 中處理I/O操作中移動的資料時，就有可能使用Buffer 函式庫。原始資料儲存在 Buffer 類別的實例中。一個 Buffer 類似於一個整數數組，但它對應於 V8 堆記憶體之外的一塊原始記憶體。

建立 Buffer 類別

Node Buffer 類別可以透過多種方式來建立。

方法1

建立長度為10 位元組的Buffer 實例：

var buf = new Buffer(10);

方法2

透過給定的陣列建立Buffer 實例：

var buf = new Buffer([10, 20, 30, 40, 50]);

方法3

透過字串來建立Buffer 實例：

var buf = new Buffer("www.php.cn", "utf-8");

utf-8 是預設的編碼方式，此外它同樣支援以下編碼："ascii", " utf8", "utf16le", "ucs2", "base64" 和"hex"。

寫入緩衝區

語法

寫入Node 緩衝區的語法如下所示：

buf.write(string[, offset[, length]][, encoding])

參數

參數描述如下：

• string - 寫入緩衝區的字串。

• offset - 緩衝區開始寫入的索引值，預設為 0 。

• length - 寫入的位元組數，預設為buffer.length

• ##encoding - 使用的編碼。預設為 'utf8' 。

buf = new Buffer(256);
len = buf.write("www.php.cn");

console.log("写入字节数 : "+  len);

$node main.js
写入字节数 : 14

##語法

讀取Node 緩衝區資料的語法如下所示：

buf.toString([encoding[, start[, end]]])

參數

參數描述如下：

##encoding
• - 使用的編碼。預設為 'utf8' 。

start
• - 指定開始讀取的索引位置，預設為 0。

end
• - 結束位置，預設為緩衝區的結尾。
  傳回值

buf = new Buffer(26);
for (var i = 0 ; i < 26 ; i++) {
  buf[i] = i + 97;
}

console.log( buf.toString('ascii'));       // 输出: abcdefghijklmnopqrstuvwxyz
console.log( buf.toString('ascii',0,5));   // 输出: abcde
console.log( buf.toString('utf8',0,5));    // 输出: abcde
console.log( buf.toString(undefined,0,5)); // 使用 'utf8' 编码, 并输出: abcde

$ node main.js
abcdefghijklmnopqrstuvwxyz
abcde
abcde
abcde

將Buffer 轉換為JSON 物件

buf.toJSON()

var buf = new Buffer('www.php.cn');
var json = buf.toJSON(buf);

console.log(json);

[ 119, 119, 119, 46, 114, 117, 110, 111, 111, 98, 46, 99, 111, 109 ]

Buffer.concat(list[, totalLength])

• list - 用於合併的 Buffer 物件陣列清單。

• totalLength - 指定合併後Buffer物件的總長度。

傳回值

傳回一個多個成員合併的新 Buffer 物件。

實例

var buffer1 = new Buffer('php中文网 ');
var buffer2 = new Buffer('www.php.cn');
var buffer3 = Buffer.concat([buffer1,buffer2]);
console.log("buffer3 内容: " + buffer3.toString());

執行上述程式碼，輸出結果為：

buffer3 内容: php中文网 www.php.cn

緩衝區比較

語法

Node Buffer比較的函數語法如下所示, 此方法在Node.js  v0.12.2 版本引入：

buf.compare(otherBuffer);

參數

參數描述如下：

otherBuffer

物件比較的另外一個Buffer 物件。

傳回值

傳回數字，表示

在

之前，之後或相同。

• 實例

  var buffer1 = new Buffer('ABC');
  var buffer2 = new Buffer('ABCD');
  var result = buffer1.compare(buffer2);
  
  if(result < 0) {
     console.log(buffer1 + " 在 " + buffer2 + "之前");
  }else if(result == 0){
     console.log(buffer1 + " 与 " + buffer2 + "相同");
  }else {
     console.log(buffer1 + " 在 " + buffer2 + "之后");
  }

  執行上述程式碼，輸出結果為：

  ABC在ABCD之前

• 拷貝緩衝區

  語法

  Node 緩衝區拷貝語法如下所示：

buf.copy(targetBuffer[, targetStart[, sourceStart[, sourceEnd]]])

• 參數

  參數描述如下：

• targetBuffer -  要拷貝的Buffer 對象。

targetStart

sourceStart

-  數字, 可選, 預設: buffer.length

#回傳值

• 沒有傳回值。 實例

  var buffer1 = new Buffer('ABC');
  // 拷贝一个缓冲区
  var buffer2 = new Buffer(3);
  buffer1.copy(buffer2);
  console.log("buffer2 content: " + buffer2.toString());

執行上述程式碼，輸出結果為：

• buffer2 content: ABC

  緩衝區裁切

  Node 緩衝區裁切語法如下所示：

buf.slice([start[, end]])

-   數字, 可選, 預設: buffer.length

傳回值

傳回一個新的緩衝區，它和舊緩衝區指向同一塊內存，但是從索引start 到end 的位置剪切。

實例

var buffer1 = new Buffer('php');
// 剪切缓冲区
var buffer2 = buffer1.slice(0,2);
console.log("buffer2 content: " + buffer2.toString());

buffer2 content: ru

緩衝區長度

buf.length;

var buffer = new Buffer('www.php.cn');
//  缓冲区长度
console.log("buffer length: " + buffer.length);

buffer length: 14

var b = new Buffer(6);
b.writeUIntBE(0x1234567890ab, 0, 6);
// <Buffer 12 34 56 78 90 ab>