Node.js Buffer(緩衝區)

標籤：

 

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("aaaaaa", "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‘ 。

傳回值

返回實際寫入的大小。如果 buffer 空間不足， 則只會寫入部分字串。

執行個體

buf = new Buffer(256);len = buf.write("aaaaaaa");console.log("寫入位元組數 : "+  len);

執行以上代碼，輸出結果為：

$node main.js寫入位元組數 : 7

從緩衝區讀取資料文法

讀取 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‘));       // 輸出: abcdefghijklmnopqrstuvwxyzconsole.log( buf.toString(‘ascii‘,0,5));   // 輸出: abcdeconsole.log( buf.toString(‘utf8‘,0,5));    // 輸出: abcdeconsole.log( buf.toString(undefined,0,5)); // 使用 ‘utf8‘ 編碼, 並輸出: abcde

執行以上代碼，輸出結果為：

$ node main.jsabcdefghijklmnopqrstuvwxyzabcdeabcdeabcde

將 Buffer 轉換為 JSON 對象文法

將 Node Buffer 轉換為 JSON 對象的函數文法格式如下：

buf.toJSON()

傳回值

返回 JSON 對象。

執行個體

var buf = new Buffer(‘node.js‘);var json = buf.toJSON(buf);console.log(json);

執行以上代碼，輸出結果為?你可以試試結果。

緩衝區合并文法

Node 緩衝區合并的文法如下所示：

Buffer.concat(list[, totalLength])

參數

參數描述如下：

• list - 用於合并的 Buffer 對象數組列表。

• totalLength - 指定合并後Buffer對象的總長度。

傳回值

返回一個多個成員合并的新 Buffer 對象。

執行個體

var buffer1 = new Buffer(‘node教程 ‘);var buffer2 = new Buffer(‘aaaaa‘);var buffer3 = Buffer.concat([buffer1,buffer2]);console.log("buffer3 內容: " + buffer3.toString());

執行以上代碼，輸出結果為：

buffer3 內容: node教程 aaaaa

緩衝區比較文法

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

buf.compare(otherBuffer);

參數

參數描述如下：

• otherBuffer - 與 buf 對象比較的另外一個 Buffer 對象。

傳回值

返回一個數字，表示 buf 在 otherBuffer 之前，之後或相同。

執行個體

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 - 數字, 可選, 預設: 0

• sourceStart - 數字, 可選, 預設: 0

• sourceEnd - 數字, 可選, 預設: 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]])

參數

參數描述如下：

• start - 數字, 可選, 預設: 0

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

傳回值

返回一個新的緩衝區，它和舊緩衝區指向同一塊記憶體，但是從索引 start 到 end 的位置剪下。

執行個體

var buffer1 = new Buffer(‘runoob‘);// 剪下緩衝區var buffer2 = buffer1.slice(0,2);console.log("buffer2 content: " + buffer2.toString());

執行以上代碼，輸出結果為：

buffer2 content: ru

緩衝區長度文法

Node 緩衝區長度計算文法如下所示：

buf.length;

傳回值

返回 Buffer 對象所佔據的記憶體長度。

執行個體

var buffer = new Buffer(‘aaaaaa‘);//  緩衝區長度console.log("buffer length: " + buffer.length);

執行以上代碼，輸出結果為：

buffer length: 6

Node.js Buffer(緩衝區)