內容:Buffer與字元編碼,Buffer創建、寫入、讀取、轉換成JSON對象、合併、比較、拷貝、裁剪、長度 Buffer 與字元編碼Buffer 實例一般用於表示編碼字元的序列,比如 UTF-8 、 UCS2 、 Base64 、或十六進位編碼的數據。 通過使用顯式的字元編碼,就可以在 Buffe ...
內容:Buffer與字元編碼,Buffer創建、寫入、讀取、轉換成JSON對象、合併、比較、拷貝、裁剪、長度
Buffer 與字元編碼
Buffer 實例一般用於表示編碼字元的序列,比如 UTF-8 、 UCS2 、 Base64 、或十六進位編碼的數據。 通過使用顯式的字元編碼,就可以在 Buffer 實例與普通的 JavaScript 字元串之間進行相互轉換。
const buf = Buffer.from('runoob', 'ascii'); // 輸出 72756e6f6f62 console.log(buf.toString('hex')); // 輸出 cnVub29i console.log(buf.toString('base64'));
##############################################################################################
創建 Buffer 類
Buffer 提供了以下 API 來創建 Buffer 類:
• Buffer.alloc(size[, fill[, encoding]]): 返回一個指定大小的 Buffer 實例,如果沒有設置 fill,則預設填滿 0
• Buffer.allocUnsafe(size): 返回一個指定大小的 Buffer 實例,但是它不會被初始化,所以它可能包含敏感的數據
• Buffer.allocUnsafeSlow(size)
• Buffer.from(array): 返回一個被 array 的值初始化的新的 Buffer 實例(傳入的 array 的元素只能是數字,不然就會自動被 0 覆蓋)
• Buffer.from(arrayBuffer[, byteOffset[, length]]): 返回一個新建的與給定的 ArrayBuffer 共用同一記憶體的 Buffer。
• Buffer.from(buffer): 複製傳入的 Buffer 實例的數據,並返回一個新的 Buffer 實例
• Buffer.from(string[, encoding]): 返回一個被 string 的值初始化的新的 Buffer 實例
// 創建一個長度為 10、且用 0 填充的 Buffer。 const buf1 = Buffer.alloc(10); // 創建一個長度為 10、且用 0x1 填充的 Buffer。 const buf2 = Buffer.alloc(10, 1); // 創建一個長度為 10、且未初始化的 Buffer。 // 這個方法比調用 Buffer.alloc() 更快, // 但返回的 Buffer 實例可能包含舊數據, // 因此需要使用 fill() 或 write() 重寫。 const buf3 = Buffer.allocUnsafe(10); // 創建一個包含 [0x1, 0x2, 0x3] 的 Buffer。 const buf4 = Buffer.from([1, 2, 3]); // 創建一個包含 UTF-8 位元組 [0x74, 0xc3, 0xa9, 0x73, 0x74] 的 Buffer。 const buf5 = Buffer.from('tést'); // 創建一個包含 Latin-1 位元組 [0x74, 0xe9, 0x73, 0x74] 的 Buffer。 const buf6 = Buffer.from('tést', 'latin1');
############################################################################################
寫入緩衝區
###語法
寫入 Node 緩衝區的語法如下所示:
buf.write(string[, offset[, length]][, encoding])
###參數
參數描述如下:
• string - 寫入緩衝區的字元串。
• offset - 緩衝區開始寫入的索引值,預設為 0 。
• length - 寫入的位元組數,預設為 buffer.length
• encoding - 使用的編碼。預設為 'utf8' 。
根據 encoding 的字元編碼寫入 string 到 buf 中的 offset 位置。 length 參數是寫入的位元組數。 如果 buf 沒有足夠的空間保存整個字元串,則只會寫入 string 的一部分。 只部分解碼的字元不會被寫入。
###返回值
返回實際寫入的大小。如果 buffer 空間不足, 則只會寫入部分字元串。
###實例
buf = Buffer.alloc(256); len = buf.write("love A"); console.log("寫入位元組數 : "+ len);
執行以上代碼,輸出結果為:
寫入位元組數 : 14
#############################################################################################
從緩衝區讀取數據
###語法
讀取 Node 緩衝區數據的語法如下所示:
buf.toString([encoding[, start[, end]]])
###參數
參數描述如下:
• encoding - 使用的編碼。預設為 'utf8' 。
• start - 指定開始讀取的索引位置,預設為 0。
• end - 結束位置,預設為緩衝區的末尾。
###返回值
解碼緩衝區數據並使用指定的編碼返回字元串。
###實例
buf = Buffer.alloc(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
執行以上代碼,輸出結果為:
abcdefghijklmnopqrstuvwxyz
abcde
abcde
abcde
#############################################################################################
將 Buffer 轉換為 JSON 對象
###語法
將 Node Buffer 轉換為 JSON 對象的函數語法格式如下:
buf.toJSON()
當字元串化一個 Buffer 實例時,JSON.stringify() 會隱式地調用該 toJSON()。
###返回值
返回 JSON 對象。
##實例
const buf = Buffer.from([0x1, 0x2, 0x3, 0x4, 0x5]); const json = JSON.stringify(buf); console.log(buf); // 輸出: {"type":"Buffer","data":[1,2,3,4,5]} console.log(json); const copy = JSON.parse(json, (key, value) => { return value && value.type === 'Buffer' ? Buffer.from(value.data) : value; }); // 輸出: <Buffer 01 02 03 04 05> console.log(copy);
執行以上代碼,輸出結果為:
<Buffer 01 02 03 04 05>
{"type":"Buffer","data":[1,2,3,4,5]}
<Buffer 01 02 03 04 05>
##############################################################################################
緩衝區合併
###語法
Node 緩衝區合併的語法如下所示:
Buffer.concat(list[, totalLength])
###參數
參數描述如下:
• list - 用於合併的 Buffer 對象數組列表。
• totalLength - 指定合併後Buffer對象的總長度。
###返回值
返回一個多個成員合併的新 Buffer 對象。
###實例
var buffer1 = Buffer.from(('Love')); var buffer2 = Buffer.from(('A')); var buffer3 = Buffer.concat([buffer1,buffer2]); console.log("buffer3 內容: " + buffer3.toString());
執行以上代碼,輸出結果為:
buffer3 內容: Love A
##############################################################################################
緩衝區比較
###語法
buf.compare(otherBuffer);
###參數
• otherBuffer - 與 buf 對象比較的另外一個 Buffer 對象。
###返回值
返回一個數字,表示 buf 在 otherBuffer 之前,之後或相同。
###實例
var buf1 = Buffer.from('zabc'); var buf2 = Buffer.from('xq'); var result = buf1.compare(buf2); if(result < 0){ console.log(buf1.toString()+'在'+buf2.toString()+'之前'); }else if (result === 0){ console.log(buf1.toString()+'與'+buf2.toString()+'相同'); }else { console.log(buf1.toString()+'在'+buf2.toString()+'之後'); }
執行以上代碼,輸出結果為:
zabc在xq之後
##########################################################################################
拷貝緩衝區
###語法
Node 緩衝區拷貝語法如下所示:
buf.copy(targetBuffer[, targetStart[, sourceStart[, sourceEnd]]])
###參數
參數描述如下:
• targetBuffer - 要拷貝的 Buffer 對象。
• targetStart - 數字, 可選, 預設: 0
• sourceStart - 數字, 可選, 預設: 0
• sourceEnd - 數字, 可選, 預設: buffer.length
###返回值
沒有返回值。
###實例
var buf1 = Buffer.from('abcdefghijkl'); var buf2 = Buffer.from('RUNOOB'); //將 buf2 插入到 buf1 指定位置上 buf2.copy(buf1, 2); console.log(buf1.toString());
執行以上代碼,輸出結果為:
abRUNOOBijkl
###########################################################################################
緩衝區裁剪
Node 緩衝區裁剪語法如下所示:
buf.slice([start[, end]])
###參數
• start - 數字, 可選, 預設: 0
• end - 數字, 可選, 預設: buffer.length
###返回值
返回一個新的緩衝區,它和舊緩衝區指向同一塊記憶體,但是從索引 start 到 end 的位置剪切。
###實例
var buffer1 = Buffer.from('runoob'); // 剪切緩衝區 var buffer2 = buffer1.slice(0,2); console.log("buffer2 content: " + buffer2.toString());
執行以上代碼,輸出結果為:
buffer2 content: ru
##########################################################################################
緩衝區長度
語法
Node 緩衝區長度計算語法如下所示:
buf.length;
返回值
返回 Buffer 對象所占據的記憶體長度。
實例
var buffer = Buffer.from('www.XXXXXXX.com'); // 緩衝區長度 console.log("buffer length: " + buffer.length);