Node.js Buffer(緩沖區(qū))
01辛块、創(chuàng)建 Buffer 類
JavaScript 語言自身只有字符串?dāng)?shù)據(jù)類型畔派,沒有二進(jìn)制數(shù)據(jù)類型。
但在處理像TCP流或文件流時(shí)润绵,必須使用到二進(jìn)制數(shù)據(jù)线椰。因此在 Node.js中,定義了一個(gè) Buffer 類尘盼,該類用來創(chuàng)建一個(gè)專門存放二進(jìn)制數(shù)據(jù)的緩存區(qū)憨愉。
在 Node.js 中烦绳,Buffer 類是隨 Node 內(nèi)核一起發(fā)布的核心庫。Buffer 庫為 Node.js 帶來了一種存儲(chǔ)原始數(shù)據(jù)的方法配紫,可以讓 Node.js 處理二進(jìn)制數(shù)據(jù)径密,每當(dāng)需要在 Node.js 中處理I/O操作中移動(dòng)的數(shù)據(jù)時(shí),就有可能使用 Buffer 庫躺孝。原始數(shù)據(jù)存儲(chǔ)在 Buffer 類的實(shí)例中享扔。一個(gè) Buffer 類似于一個(gè)整數(shù)數(shù)組,但它對應(yīng)于 V8 堆內(nèi)存之外的一塊原始內(nèi)存植袍。
創(chuàng)建 Buffer 類
Node Buffer 類可以通過多種方式來創(chuàng)建惧眠。
方法 1
創(chuàng)建長度為 10 字節(jié)的 Buffer 實(shí)例:
var buf = new Buffer(10);
方法 2
通過給定的數(shù)組創(chuàng)建 Buffer 實(shí)例:
var buf = new Buffer([10, 20, 30, 40, 50]);
方法 3
通過一個(gè)字符串來創(chuàng)建 Buffer 實(shí)例:
var buf = new Buffer("www.runoob.com", "utf-8");
utf-8 是默認(rèn)的編碼方式,此外它同樣支持以下編碼:"ascii", "utf8", "utf16le", "ucs2", "base64" 和 "hex"
02奋单、寫入緩沖區(qū)
語法
寫入 Node 緩沖區(qū)的語法如下所示:
buf.write(string[, offset[, length]][, encoding])
參數(shù)描述如下:
string - 寫入緩沖區(qū)的字符串锉试。
offset - 緩沖區(qū)開始寫入的索引值,默認(rèn)為 0 览濒。
length - 寫入的字節(jié)數(shù)呆盖,默認(rèn)為 buffer.length
encoding - 使用的編碼。默認(rèn)為 'utf8' 贷笛。
返回值
返回實(shí)際寫入的大小应又。如果 buffer 空間不足, 則只會(huì)寫入部分字符串乏苦。
buf = new Buffer(256);
len = buf.write("www.runoob.com");
console.log("寫入字節(jié)數(shù) : "+ len);
執(zhí)行以上代碼株扛,輸出結(jié)果為:
$node main.js
寫入字節(jié)數(shù) : 14
03、從緩沖區(qū)讀取數(shù)據(jù)
語法
讀取 Node 緩沖區(qū)數(shù)據(jù)的語法如下所示:
buf.toString([encoding[, start[, end]]])
參數(shù)描述如下:
encoding - 使用的編碼汇荐。默認(rèn)為 'utf8' 洞就。
start - 指定開始讀取的索引位置,默認(rèn)為 0掀淘。
end - 結(jié)束位置旬蟋,默認(rèn)為緩沖區(qū)的末尾。
返回值
解碼緩沖區(qū)數(shù)據(jù)并使用指定的編碼返回字符串革娄。
實(shí)例:
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
執(zhí)行以上代碼倾贰,輸出結(jié)果為:
$ node main.js
abcdefghijklmnopqrstuvwxyz
abcde
abcde
abcde
04、將 Buffer 轉(zhuǎn)換為 JSON 對象
buf.toJSON()
返回 JSON 對象拦惋。
var buf = new Buffer('www.runoob.com');
var json = buf.toJSON(buf);
console.log(json);
執(zhí)行以上代碼匆浙,輸出結(jié)果為:
[ 119, 119, 119, 46, 114, 117, 110, 111, 111, 98, 46, 99, 111, 109 ]
05、緩沖區(qū)合并
Node 緩沖區(qū)合并的語法如下所示:
Buffer.concat(list[, totalLength])
參數(shù)描述如下:
list - 用于合并的 Buffer 對象數(shù)組列表厕妖。
totalLength - 指定合并后Buffer對象的總長度首尼。
返回一個(gè)多個(gè)成員合并的新 Buffer 對象。
var buffer1 = new Buffer('玩轉(zhuǎn)nodejs');
var buffer2 = new Buffer('www.heliang.com');
var buffer3 = Buffer.concat([buffer1,buffer2]);
console.log("buffer3 內(nèi)容: " + buffer3.toString());
執(zhí)行以上代碼,輸出結(jié)果為:
buffer3 內(nèi)容: 玩轉(zhuǎn)nodejs www.heliang.com
06饰恕、緩沖區(qū)比較
Node Buffer 比較的函數(shù)語法如下所示, 該方法在 Node.js v0.12.2 版本引入:
buf.compare(otherBuffer);
參數(shù)描述如下:
otherBuffer - 與 buf 對象比較的另外一個(gè) Buffer 對象挠羔。
返回一個(gè)數(shù)字,表示 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 + "之后");
}
07、拷貝緩沖區(qū)
buf.copy(targetBuffer[, targetStart[, sourceStart[, sourceEnd]]])
參數(shù)
targetBuffer - 要拷貝的 Buffer 對象雹嗦。
targetStart - 數(shù)字, 可選, 默認(rèn): 0
sourceStart - 數(shù)字, 可選, 默認(rèn): 0
sourceEnd - 數(shù)字, 可選, 默認(rèn): buffer.length
var buffer1 = new Buffer('ABC');
// 拷貝一個(gè)緩沖區(qū)
var buffer2 = new Buffer(3);
buffer1.copy(buffer2);
console.log("buffer2 content: " + buffer2.toString());
執(zhí)行以上代碼范舀,輸出結(jié)果為:
buffer2 content: ABC
08、緩沖區(qū)裁剪
Node 緩沖區(qū)裁剪語法如下所示:
buf.slice([start[, end]])
參數(shù)
start - 數(shù)字, 可選, 默認(rèn): 0
end - 數(shù)字, 可選, 默認(rèn): buffer.length
返回一個(gè)新的緩沖區(qū)了罪,它和舊緩沖區(qū)指向同一塊內(nèi)存锭环,但是從索引 start 到 end 的位置剪切。
var buffer1 = new Buffer('runoob');
// 剪切緩沖區(qū)
var buffer2 = buffer1.slice(0,2);
console.log("buffer2 content: " + buffer2.toString());
執(zhí)行以上代碼泊藕,輸出結(jié)果為:
buffer2 content: ru
09辅辩、緩沖區(qū)長度
buf.length;
var buffer = new Buffer('www.runoob.com'); // 緩沖區(qū)長度
console.log("buffer length: " + buffer.length);
10、方法參考手冊
以下列出了 Node.js Buffer 模塊常用的方法(注意有些方法在舊版本是沒有的):
序號(hào) 方法 & 描述
1 new Buffer(size)
分配一個(gè)新的 size 大小單位為8位字節(jié)的 buffer娃圆。 注意, size 必須小于 kMaxLength玫锋,否則,將會(huì)拋出異常 RangeError讼呢。
2 new Buffer(buffer)
拷貝參數(shù) buffer 的數(shù)據(jù)到 Buffer 實(shí)例撩鹿。
3 new Buffer(str[, encoding])
分配一個(gè)新的 buffer ,其中包含著傳入的 str 字符串悦屏。 encoding 編碼方式默認(rèn)為 'utf8'节沦。
4 buf.length
返回這個(gè) buffer 的 bytes 數(shù)。注意這未必是 buffer 里面內(nèi)容的大小础爬。length 是 buffer 對象所分配的內(nèi)存數(shù)甫贯,它不會(huì)隨著這個(gè) buffer 對象內(nèi)容的改變而改變。
5 buf.write(string[, offset[, length]][, encoding])
根據(jù)參數(shù) offset 偏移量和指定的 encoding 編碼方式看蚜,將參數(shù) string 數(shù)據(jù)寫入buffer叫搁。 offset 偏移量默認(rèn)值是 0, encoding 編碼方式默認(rèn)是 utf8。 length 長度是將要寫入的字符串的 bytes 大小失乾。 返回 number 類型,表示寫入了多少 8 位字節(jié)流纬乍。如果 buffer 沒有足夠的空間來放整個(gè) string碱茁,它將只會(huì)只寫入部分字符串。 length 默認(rèn)是 buffer.length - offset仿贬。 這個(gè)方法不會(huì)出現(xiàn)寫入部分字符纽竣。
6 buf.writeUIntLE(value, offset, byteLength[, noAssert])
將 value 寫入到 buffer 里, 它由 offset 和 byteLength 決定,最高支持 48 位無符號(hào)整數(shù)蜓氨,小端對齊聋袋,例如:
var b = new Buffer(6);
b.writeUIntBE(0x1234567890ab, 0, 6);
// <Buffer 12 34 56 78 90 ab> noAssert 值為 true 時(shí),不再驗(yàn)證 value 和 offset 的有效性穴吹。 默認(rèn)是 false幽勒。
7 buf.writeUIntBE(value, offset, byteLength[, noAssert])
將 value 寫入到 buffer 里, 它由 offset 和 byteLength 決定港令,最高支持 48 位無符號(hào)整數(shù)啥容,大端對齊。noAssert 值為 true 時(shí)顷霹,不再驗(yàn)證 value 和 offset 的有效性咪惠。 默認(rèn)是 false。
8 buf.writeIntLE(value, offset, byteLength[, noAssert])
將value 寫入到 buffer 里淋淀, 它由offset 和 byteLength 決定遥昧,最高支持48位有符號(hào)整數(shù),小端對齊朵纷。noAssert 值為 true 時(shí)炭臭,不再驗(yàn)證 value 和 offset 的有效性。 默認(rèn)是 false柴罐。
9 buf.writeIntBE(value, offset, byteLength[, noAssert])
將value 寫入到 buffer 里徽缚, 它由offset 和 byteLength 決定,最高支持48位有符號(hào)整數(shù)革屠,大端對齊凿试。noAssert 值為 true 時(shí),不再驗(yàn)證 value 和 offset 的有效性似芝。 默認(rèn)是 false那婉。
10 buf.readUIntLE(offset, byteLength[, noAssert])
支持讀取 48 位以下的無符號(hào)數(shù)字,小端對齊党瓮。noAssert 值為 true 時(shí)详炬, offset 不再驗(yàn)證是否超過 buffer 的長度,默認(rèn)為 false寞奸。
11 buf.readUIntBE(offset, byteLength[, noAssert])
支持讀取 48 位以下的無符號(hào)數(shù)字呛谜,大端對齊。noAssert 值為 true 時(shí)枪萄, offset 不再驗(yàn)證是否超過 buffer 的長度隐岛,默認(rèn)為 false。
12 buf.readIntLE(offset, byteLength[, noAssert])
支持讀取 48 位以下的有符號(hào)數(shù)字瓷翻,小端對齊聚凹。noAssert 值為 true 時(shí)割坠, offset 不再驗(yàn)證是否超過 buffer 的長度,默認(rèn)為 false妒牙。
13 buf.readIntBE(offset, byteLength[, noAssert])
支持讀取 48 位以下的有符號(hào)數(shù)字彼哼,大端對齊。noAssert 值為 true 時(shí)湘今, offset 不再驗(yàn)證是否超過 buffer 的長度敢朱,默認(rèn)為 false。
14 buf.toString([encoding[, start[, end]]])
根據(jù) encoding 參數(shù)(默認(rèn)是 'utf8')返回一個(gè)解碼過的 string 類型象浑。還會(huì)根據(jù)傳入的參數(shù) start (默認(rèn)是 0) 和 end (默認(rèn)是 buffer.length)作為取值范圍蔫饰。
15 buf.toJSON()
將 Buffer 實(shí)例轉(zhuǎn)換為 JSON 對象。
16 buf[index]
獲取或設(shè)置指定的字節(jié)愉豺。返回值代表一個(gè)字節(jié)篓吁,所以返回值的合法范圍是十六進(jìn)制0x00到0xFF 或者十進(jìn)制0至 255。
17 buf.equals(otherBuffer)
比較兩個(gè)緩沖區(qū)是否相等蚪拦,如果是返回 true杖剪,否則返回 false。
18 buf.compare(otherBuffer)
比較兩個(gè) Buffer 對象驰贷,返回一個(gè)數(shù)字盛嘿,表示 buf 在 otherBuffer 之前,之后或相同括袒。
19 buf.copy(targetBuffer[, targetStart[, sourceStart[, sourceEnd]]])
buffer 拷貝次兆,源和目標(biāo)可以相同。 targetStart 目標(biāo)開始偏移和 sourceStart 源開始偏移默認(rèn)都是 0锹锰。 sourceEnd 源結(jié)束位置偏移默認(rèn)是源的長度 buffer.length 芥炭。
20 buf.slice([start[, end]])
剪切 Buffer 對象,根據(jù) start(默認(rèn)是 0 ) 和 end (默認(rèn)是 buffer.length ) 偏移和裁剪了索引恃慧。 負(fù)的索引是從 buffer 尾部開始計(jì)算的园蝠。
21 buf.readUInt8(offset[, noAssert])
根據(jù)指定的偏移量,讀取一個(gè)無符號(hào) 8 位整數(shù)痢士。若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)彪薛。 如果這樣 offset 可能會(huì)超出buffer 的末尾。默認(rèn)是 false怠蹂。
22 buf.readUInt16LE(offset[, noAssert])
根據(jù)指定的偏移量善延,使用特殊的 endian 字節(jié)序格式讀取一個(gè)無符號(hào) 16 位整數(shù)。若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)城侧。 這意味著 offset 可能會(huì)超出 buffer 的末尾易遣。默認(rèn)是 false。
23 buf.readUInt16BE(offset[, noAssert])
根據(jù)指定的偏移量赞庶,使用特殊的 endian 字節(jié)序格式讀取一個(gè)無符號(hào) 16 位整數(shù)训挡,大端對齊。若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)歧强。 這意味著 offset 可能會(huì)超出 buffer 的末尾澜薄。默認(rèn)是 false。
24 buf.readUInt32LE(offset[, noAssert])
根據(jù)指定的偏移量摊册,使用指定的 endian 字節(jié)序格式讀取一個(gè)無符號(hào) 32 位整數(shù)肤京,小端對齊。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)茅特。 這意味著 offset 可能會(huì)超出buffer 的末尾忘分。默認(rèn)是 false。
25 buf.readUInt32BE(offset[, noAssert])
根據(jù)指定的偏移量白修,使用指定的 endian 字節(jié)序格式讀取一個(gè)無符號(hào) 32 位整數(shù)妒峦,大端對齊。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)兵睛。 這意味著 offset 可能會(huì)超出buffer 的末尾肯骇。默認(rèn)是 false。
26 buf.readInt8(offset[, noAssert])
根據(jù)指定的偏移量祖很,讀取一個(gè)有符號(hào) 8 位整數(shù)笛丙。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)。 這意味著 offset 可能會(huì)超出 buffer 的末尾假颇。默認(rèn)是 false胚鸯。
27 buf.readInt16LE(offset[, noAssert])
根據(jù)指定的偏移量,使用特殊的 endian 格式讀取一個(gè) 有符號(hào) 16 位整數(shù)笨鸡,小端對齊姜钳。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)。 這意味著 offset 可能會(huì)超出 buffer 的末尾镜豹。默認(rèn)是 false傲须。
28 buf.readInt16BE(offset[, noAssert])
根據(jù)指定的偏移量,使用特殊的 endian 格式讀取一個(gè) 有符號(hào) 16 位整數(shù)趟脂,大端對齊泰讽。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)。 這意味著 offset 可能會(huì)超出 buffer 的末尾昔期。默認(rèn)是 false已卸。
29 buf.readInt32LE(offset[, noAssert])
根據(jù)指定的偏移量,使用指定的 endian 字節(jié)序格式讀取一個(gè)有符號(hào) 32 位整數(shù)硼一,小端對齊累澡。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)。 這意味著 offset 可能會(huì)超出buffer 的末尾般贼。默認(rèn)是 false愧哟。
30 buf.readInt32BE(offset[, noAssert])
根據(jù)指定的偏移量奥吩,使用指定的 endian 字節(jié)序格式讀取一個(gè)有符號(hào) 32 位整數(shù),大端對齊蕊梧。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)霞赫。 這意味著 offset 可能會(huì)超出buffer 的末尾。默認(rèn)是 false肥矢。
31 buf.readFloatLE(offset[, noAssert])
根據(jù)指定的偏移量端衰,使用指定的 endian 字節(jié)序格式讀取一個(gè) 32 位雙浮點(diǎn)數(shù),小端對齊甘改。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)旅东。 這意味著 offset 可能會(huì)超出buffer的末尾。默認(rèn)是 false十艾。
32 buf.readFloatBE(offset[, noAssert])
根據(jù)指定的偏移量抵代,使用指定的 endian 字節(jié)序格式讀取一個(gè) 32 位雙浮點(diǎn)數(shù),大端對齊忘嫉。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)主守。 這意味著 offset 可能會(huì)超出buffer的末尾。默認(rèn)是 false榄融。
33 buf.readDoubleLE(offset[, noAssert])
根據(jù)指定的偏移量参淫,使用指定的 endian字節(jié)序格式讀取一個(gè) 64 位雙精度數(shù),小端對齊愧杯。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)涎才。 這意味著 offset 可能會(huì)超出buffer 的末尾。默認(rèn)是 false力九。
34 buf.readDoubleBE(offset[, noAssert])
根據(jù)指定的偏移量耍铜,使用指定的 endian字節(jié)序格式讀取一個(gè) 64 位雙精度數(shù),大端對齊跌前。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)棕兼。 這意味著 offset 可能會(huì)超出buffer 的末尾。默認(rèn)是 false抵乓。
35 buf.writeUInt8(value, offset[, noAssert])
根據(jù)傳入的 offset 偏移量將 value 寫入 buffer伴挚。注意:value 必須是一個(gè)合法的無符號(hào) 8 位整數(shù)。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)灾炭。 這意味著 value 可能過大茎芋,或者 offset 可能會(huì)超出 buffer 的末尾從而造成 value 被丟棄。 除非你對這個(gè)參數(shù)非常有把握蜈出,否則不要使用田弥。默認(rèn)是 false。
36 buf.writeUInt16LE(value, offset[, noAssert])
根據(jù)傳入的 offset 偏移量和指定的 endian 格式將 value 寫入 buffer铡原。注意:value 必須是一個(gè)合法的無符號(hào) 16 位整數(shù)偷厦,小端對齊商叹。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)。 這意味著 value 可能過大只泼,或者 offset 可能會(huì)超出buffer的末尾從而造成 value 被丟棄沈自。 除非你對這個(gè)參數(shù)非常有把握,否則盡量不要使用辜妓。默認(rèn)是 false。
37 buf.writeUInt16BE(value, offset[, noAssert])
根據(jù)傳入的 offset 偏移量和指定的 endian 格式將 value 寫入 buffer忌怎。注意:value 必須是一個(gè)合法的無符號(hào) 16 位整數(shù)籍滴,大端對齊。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)榴啸。 這意味著 value 可能過大孽惰,或者 offset 可能會(huì)超出buffer的末尾從而造成 value 被丟棄。 除非你對這個(gè)參數(shù)非常有把握鸥印,否則盡量不要使用勋功。默認(rèn)是 false。
38 buf.writeUInt32LE(value, offset[, noAssert])
根據(jù)傳入的 offset 偏移量和指定的 endian 格式(LITTLE-ENDIAN:小字節(jié)序)將 value 寫入buffer库说。注意:value 必須是一個(gè)合法的無符號(hào) 32 位整數(shù)狂鞋,小端對齊。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)潜的。 這意味著value 可能過大骚揍,或者offset可能會(huì)超出buffer的末尾從而造成 value 被丟棄含末。 除非你對這個(gè)參數(shù)非常有把握眶熬,否則盡量不要使用。默認(rèn)是 false懦砂。
39 buf.writeUInt32BE(value, offset[, noAssert])
根據(jù)傳入的 offset 偏移量和指定的 endian 格式(Big-Endian:大字節(jié)序)將 value 寫入buffer亡呵。注意:value 必須是一個(gè)合法的有符號(hào) 32 位整數(shù)抽活。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)。 這意味著 value 可能過大锰什,或者offset可能會(huì)超出buffer的末尾從而造成 value 被丟棄下硕。 除非你對這個(gè)參數(shù)非常有把握,否則盡量不要使用汁胆。默認(rèn)是 false卵牍。
40 buf.writeInt8(value, offset[, noAssert])
41 buf.writeInt16LE(value, offset[, noAssert])
根據(jù)傳入的 offset 偏移量和指定的 endian 格式將 value 寫入 buffer。注意:value 必須是一個(gè)合法的 signed 16 位整數(shù)沦泌。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)糊昙。 這意味著 value 可能過大,或者 offset 可能會(huì)超出 buffer 的末尾從而造成 value 被丟棄谢谦。 除非你對這個(gè)參數(shù)非常有把握释牺,否則盡量不要使用萝衩。默認(rèn)是 false 。
42 buf.writeInt16BE(value, offset[, noAssert])
根據(jù)傳入的 offset 偏移量和指定的 endian 格式將 value 寫入 buffer没咙。注意:value 必須是一個(gè)合法的 signed 16 位整數(shù)猩谊。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)。 這意味著 value 可能過大祭刚,或者 offset 可能會(huì)超出 buffer 的末尾從而造成 value 被丟棄牌捷。 除非你對這個(gè)參數(shù)非常有把握,否則盡量不要使用涡驮。默認(rèn)是 false 暗甥。
43 buf.writeInt32LE(value, offset[, noAssert])
根據(jù)傳入的 offset 偏移量和指定的 endian 格式將 value 寫入 buffer。注意:value 必須是一個(gè)合法的 signed 32 位整數(shù)捉捅。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)撤防。 這意味著 value 可能過大,或者 offset 可能會(huì)超出 buffer 的末尾從而造成 value 被丟棄棒口。 除非你對這個(gè)參數(shù)非常有把握寄月,否則盡量不要使用。默認(rèn)是 false无牵。
44 buf.writeInt32BE(value, offset[, noAssert])
根據(jù)傳入的 offset 偏移量和指定的 endian 格式將 value 寫入 buffer漾肮。注意:value 必須是一個(gè)合法的 signed 32 位整數(shù)。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)茎毁。 這意味著 value 可能過大初橘,或者 offset 可能會(huì)超出 buffer 的末尾從而造成 value 被丟棄。 除非你對這個(gè)參數(shù)非常有把握充岛,否則盡量不要使用保檐。默認(rèn)是 false。
45 buf.writeFloatLE(value, offset[, noAssert])
根據(jù)傳入的 offset 偏移量和指定的 endian 格式將 value 寫入 buffer 崔梗。注意:當(dāng) value 不是一個(gè) 32 位浮點(diǎn)數(shù)類型的值時(shí)夜只,結(jié)果將是不確定的。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)蒜魄。 這意味著 value可能過大扔亥,或者 offset 可能會(huì)超出 buffer 的末尾從而造成 value 被丟棄。 除非你對這個(gè)參數(shù)非常有把握谈为,否則盡量不要使用旅挤。默認(rèn)是 false。
46 buf.writeFloatBE(value, offset[, noAssert])
根據(jù)傳入的 offset 偏移量和指定的 endian 格式將 value 寫入 buffer 伞鲫。注意:當(dāng) value 不是一個(gè) 32 位浮點(diǎn)數(shù)類型的值時(shí)粘茄,結(jié)果將是不確定的。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)。 這意味著 value可能過大柒瓣,或者 offset 可能會(huì)超出 buffer 的末尾從而造成 value 被丟棄儒搭。 除非你對這個(gè)參數(shù)非常有把握,否則盡量不要使用芙贫。默認(rèn)是 false搂鲫。
47 buf.writeDoubleLE(value, offset[, noAssert])
根據(jù)傳入的 offset 偏移量和指定的 endian 格式將 value 寫入 buffer。注意:value 必須是一個(gè)有效的 64 位double 類型的值磺平。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)魂仍。 這意味著 value 可能過大,或者 offset 可能會(huì)超出 buffer 的末尾從而造成value被丟棄拣挪。 除非你對這個(gè)參數(shù)非常有把握擦酌,否則盡量不要使用。默認(rèn)是 false媒吗。
48 buf.writeDoubleBE(value, offset[, noAssert])
根據(jù)傳入的 offset 偏移量和指定的 endian 格式將 value 寫入 buffer。注意:value 必須是一個(gè)有效的 64 位double 類型的值乙埃。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)闸英。 這意味著 value 可能過大,或者 offset 可能會(huì)超出 buffer 的末尾從而造成value被丟棄介袜。 除非你對這個(gè)參數(shù)非常有把握甫何,否則盡量不要使用。默認(rèn)是 false遇伞。
49 buf.fill(value[, offset][, end])
使用指定的 value 來填充這個(gè) buffer辙喂。如果沒有指定 offset (默認(rèn)是 0) 并且 end (默認(rèn)是 buffer.length) ,將會(huì)填充整個(gè)buffer鸠珠。