Node.js Buffer(緩沖區(qū))
JavaScript 語(yǔ)言自身只有字符串?dāng)?shù)據(jù)類型嫉戚,沒(méi)有二進(jìn)制數(shù)據(jù)類型刨裆。
但在處理像TCP流或文件流時(shí),必須使用到二進(jìn)制數(shù)據(jù)彬檀。因此在 Node.js中帆啃,定義了一個(gè) Buffer 類,該類用來(lái)創(chuàng)建一個(gè)專門(mén)存放二進(jìn)制數(shù)據(jù)的緩存區(qū)窍帝。
在 Node.js 中努潘,Buffer 類是隨 Node 內(nèi)核一起發(fā)布的核心庫(kù)。Buffer 庫(kù)為 Node.js 帶來(lái)了一種存儲(chǔ)原始數(shù)據(jù)的方法盯桦,可以讓 Node.js 處理二進(jìn)制數(shù)據(jù)慈俯,每當(dāng)需要在 Node.js 中處理I/O操作中移動(dòng)的數(shù)據(jù)時(shí),就有可能使用 Buffer 庫(kù)拥峦。原始數(shù)據(jù)存儲(chǔ)在 Buffer 類的實(shí)例中贴膘。一個(gè) Buffer 類似于一個(gè)整數(shù)數(shù)組,但它對(duì)應(yīng)于 V8 堆內(nèi)存之外的一塊原始內(nèi)存略号。
創(chuàng)建 Buffer 類
Node Buffer 類可以通過(guò)多種方式來(lái)創(chuàng)建刑峡。
<li>創(chuàng)建長(zhǎng)度為 10 字節(jié)的 Buffer 實(shí)例:
var buf = new Buffer(10);
<li>通過(guò)給定的數(shù)組創(chuàng)建 Buffer 實(shí)例:
var buf = new Buffer([10, 20, 30, 40, 50]);
<li>通過(guò)一個(gè)字符串來(lái)創(chuàng)建 Buffer 實(shí)例:
var buf = new Buffer("hello node.js", "utf-8");
utf-8 是默認(rèn)的編碼方式,此外它同樣支持以下編碼:"ascii", "utf8", "utf16le", "ucs2", "base64" 和 "hex"玄柠。
寫(xiě)入緩沖區(qū)
語(yǔ)法
寫(xiě)入 Node 緩沖區(qū)的語(yǔ)法如下所示:
buf.write(string[, offset[, length]][, encoding])
參#數(shù)
參數(shù)描述如下:
<li>String 寫(xiě)入緩沖區(qū)的字符串
<li>offset - 緩沖區(qū)開(kāi)始寫(xiě)入的索引值突梦,默認(rèn)為 0 。
<li>length - 寫(xiě)入的字節(jié)數(shù)羽利,默認(rèn)為 buffer.length
<li>encoding - 使用的編碼宫患。默認(rèn)為 'utf8' 。
返回值
返回實(shí)際寫(xiě)入的大小这弧。如果 buffer 空間不足娃闲, 則只會(huì)寫(xiě)入部分字符串。
實(shí)例
buf = new Buffer(256);
len = buf.write("hello node");
console.log("寫(xiě)入字節(jié)數(shù) : "+ len);
執(zhí)行以上代碼匾浪,輸出結(jié)果為:
從緩沖區(qū)讀取數(shù)據(jù)
語(yǔ)法
讀取 Node 緩沖區(qū)數(shù)據(jù)的語(yǔ)法如下所示:
buf.toString([encoding[, start[, end]]])
參數(shù)
參數(shù)描述如下:
<li>encoding - 使用的編碼皇帮。默認(rèn)為 'utf8' 。
<li>start - 指定開(kāi)始讀取的索引位置蛋辈,默認(rèn)為 0属拾。
<li>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é)果為:
將 Buffer 轉(zhuǎn)換為 JSON 對(duì)象
語(yǔ)法
將 Node Buffer 轉(zhuǎn)換為 JSON 對(duì)象的函數(shù)語(yǔ)法格式如下:
buf.toJSON();
返回值
返回 JSON 對(duì)象逞频。
實(shí)例
var buf = new Buffer('hello node');
var json = buf.toJSON(buf);
console.log(json);
執(zhí)行以上代碼礼预,輸出結(jié)果為:
緩沖區(qū)合并
語(yǔ)法
Node 緩沖區(qū)合并的語(yǔ)法如下所示:
Buffer.concat(list[, totalLength])
參數(shù)
參數(shù)描述如下:
<li>list - 用于合并的 Buffer 對(duì)象數(shù)組列表。
<li>totalLength - 指定合并后Buffer對(duì)象的總長(zhǎng)度虏劲。
返回值
返回一個(gè)多個(gè)成員合并的新 Buffer 對(duì)象托酸。
實(shí)例
var buffer1 = new Buffer('菜鳥(niǎo)教程 ');
var buffer2 = new Buffer('www.runoob.com');
var buffer3 = Buffer.concat([buffer1,buffer2]);
console.log("buffer3 內(nèi)容: " + buffer3.toString());
執(zhí)行以上代碼褒颈,輸出結(jié)果為:
緩沖區(qū)比較
語(yǔ)法
Node Buffer 比較的函數(shù)語(yǔ)法如下所示, 該方法在 Node.js v0.12.2 版本引入:
buf.compare(otherBuffer);
參數(shù)
參數(shù)描述如下:
<li>otherBuffer - 與 buf 對(duì)象比較的另外一個(gè) Buffer 對(duì)象。
返回值
返回一個(gè)數(shù)字励堡,表示 buf 在 otherBuffer 之前谷丸,之后或相同。
實(shí)例
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 + "之后");
}
執(zhí)行以上代碼应结,輸出結(jié)果為:
拷貝緩沖區(qū)
語(yǔ)法
Node 緩沖區(qū)拷貝語(yǔ)法如下所示:
buf.copy(targetBuffer[, targetStart[, sourceStart[, sourceEnd]]])
參數(shù)
參數(shù)描述如下:
<li>targetBuffer - 要拷貝的 Buffer 對(duì)象刨疼。
<li>targetStart - 數(shù)字, 可選, 默認(rèn): 0
<li>sourceStart - 數(shù)字, 可選, 默認(rèn): 0
<li>sourceEnd - 數(shù)字, 可選, 默認(rèn): buffer.length
返回值
沒(méi)有返回值。
實(shí)例
var buffer1 = new Buffer('ABC');
// 拷貝一個(gè)緩沖區(qū)
var buffer2 = new Buffer(3);
buffer1.copy(buffer2);
console.log("buffer2 content: " + buffer2.toString());
執(zhí)行以上代碼鹅龄,輸出結(jié)果為:
緩沖區(qū)裁剪
Node 緩沖區(qū)裁剪語(yǔ)法如下所示:
buf.slice([start[, end]])
參數(shù)
參數(shù)描述如下:
<li>start - 數(shù)字, 可選, 默認(rèn): 0
<li>end - 數(shù)字, 可選, 默認(rèn): buffer.length
返回值
返回一個(gè)新的緩沖區(qū)揩慕,它和舊緩沖區(qū)指向同一塊內(nèi)存,但是從索引 start 到 end 的位置剪切扮休。
實(shí)例
var buffer1 = new Buffer('helloworld');
// 剪切緩沖區(qū)
var buffer2 = buffer1.slice(0,2);
console.log("buffer2 content: " + buffer2.toString());
執(zhí)行以上代碼迎卤,輸出結(jié)果為:
緩沖區(qū)長(zhǎng)度
語(yǔ)法
Node 緩沖區(qū)長(zhǎng)度計(jì)算語(yǔ)法如下所示:
buf.length;
返回值
返回 Buffer 對(duì)象所占據(jù)的內(nèi)存長(zhǎng)度。
實(shí)例
var buffer = new Buffer('helloworld');
// 緩沖區(qū)長(zhǎng)度
console.log("buffer length: " + buffer.length);
執(zhí)行以上代碼玷坠,輸出結(jié)果為:
方法參考手冊(cè)
以下列出了 Node.js Buffer 模塊常用的方法(注意有些方法在舊版本是沒(méi)有的):
<li>new Buffer(size) 分配一個(gè)新的 size 大小單位為8位字節(jié)的 buffer蜗搔。 注意, size 必須小于 kMaxLength,否則八堡,將會(huì)拋出異常 RangeError樟凄。
<li>new Buffer(buffer) 拷貝參數(shù) buffer 的數(shù)據(jù)到 Buffer 實(shí)例。
<li>new Buffer(str[, encoding])分配一個(gè)新的 buffer 兄渺,其中包含著傳入的 str 字符串缝龄。 encoding 編碼方式默認(rèn)為 'utf8'。
<li>buf.length 返回這個(gè) buffer 的 bytes 數(shù)挂谍。注意這未必是 buffer 里面內(nèi)容的大小二拐。length 是 buffer 對(duì)象所分配的內(nèi)存數(shù),它不會(huì)隨著這個(gè) buffer 對(duì)象內(nèi)容的改變而改變凳兵。
<li>buf.write(string[, offset[, length]][, encoding])根據(jù)參數(shù) offset 偏移量和指定的 encoding 編碼方式,將參數(shù) string 數(shù)據(jù)寫(xiě)入buffer企软。 offset 偏移量默認(rèn)值是 0, encoding 編碼方式默認(rèn)是 utf8庐扫。 length 長(zhǎng)度是將要寫(xiě)入的字符串的 bytes 大小。 返回 number 類型仗哨,表示寫(xiě)入了多少 8 位字節(jié)流形庭。如果 buffer 沒(méi)有足夠的空間來(lái)放整個(gè) string,它將只會(huì)只寫(xiě)入部分字符串厌漂。 length 默認(rèn)是 buffer.length - offset萨醒。 這個(gè)方法不會(huì)出現(xiàn)寫(xiě)入部分字符。
<li>buf.writeUIntLE(value, offset, byteLength[, noAssert])將 value 寫(xiě)入到 buffer 里苇倡, 它由 offset 和 byteLength 決定富纸,最高支持 48 位無(wú)符號(hào)整數(shù)囤踩,小端對(duì)齊,例如:
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。
<li>buf.writeUIntBE(value, offset, byteLength[, noAssert])將 value 寫(xiě)入到 buffer 里涣仿, 它由 offset 和 byteLength 決定勤庐,最高支持 48 位無(wú)符號(hào)整數(shù),大端對(duì)齊好港。noAssert 值為 true 時(shí)愉镰,不再驗(yàn)證 value 和 offset 的有效性。 默認(rèn)是 false钧汹。
<li>buf.writeIntLE(value, offset, byteLength[, noAssert])將value 寫(xiě)入到 buffer 里丈探, 它由offset 和 byteLength 決定,最高支持48位有符號(hào)整數(shù)崭孤,小端對(duì)齊类嗤。noAssert 值為 true 時(shí),不再驗(yàn)證 value 和 offset 的有效性辨宠。 默認(rèn)是 false遗锣。
<li>buf.writeIntBE(value, offset, byteLength[, noAssert])將value 寫(xiě)入到 buffer 里, 它由offset 和 byteLength 決定嗤形,最高支持48位有符號(hào)整數(shù)精偿,大端對(duì)齊。noAssert 值為 true 時(shí)赋兵,不再驗(yàn)證 value 和 offset 的有效性笔咽。 默認(rèn)是 false。
<li>buf.readUIntLE(offset, byteLength[, noAssert])支持讀取 48 位以下的無(wú)符號(hào)數(shù)字霹期,小端對(duì)齊叶组。noAssert 值為 true 時(shí), offset 不再驗(yàn)證是否超過(guò) buffer 的長(zhǎng)度历造,默認(rèn)為 false甩十。
<li>buf.readUIntBE(offset, byteLength[, noAssert])支持讀取 48 位以下的無(wú)符號(hào)數(shù)字,大端對(duì)齊吭产。noAssert 值為 true 時(shí)侣监, offset 不再驗(yàn)證是否超過(guò) buffer 的長(zhǎng)度,默認(rèn)為 false臣淤。
<li>buf.readIntLE(offset, byteLength[, noAssert])支持讀取 48 位以下的有符號(hào)數(shù)字橄霉,小端對(duì)齊。noAssert 值為 true 時(shí)邑蒋, offset 不再驗(yàn)證是否超過(guò) buffer 的長(zhǎng)度姓蜂,默認(rèn)為 false按厘。
<li>buf.readIntBE(offset, byteLength[, noAssert])支持讀取 48 位以下的有符號(hào)數(shù)字,大端對(duì)齊覆糟。noAssert 值為 true 時(shí)刻剥, offset 不再驗(yàn)證是否超過(guò) buffer 的長(zhǎng)度,默認(rèn)為 false滩字。
<li>buf.toString([encoding[, start[, end]]])根據(jù) encoding 參數(shù)(默認(rèn)是 'utf8')返回一個(gè)解碼過(guò)的 string 類型造虏。還會(huì)根據(jù)傳入的參數(shù) start (默認(rèn)是 0) 和 end (默認(rèn)是 buffer.length)作為取值范圍。
<li>buf.toJSON()將 Buffer 實(shí)例轉(zhuǎn)換為 JSON 對(duì)象麦箍。
<li>buf[index]獲取或設(shè)置指定的字節(jié)漓藕。返回值代表一個(gè)字節(jié),所以返回值的合法范圍是十六進(jìn)制0x00到0xFF 或者十進(jìn)制0至 255挟裂。
<li>buf.equals(otherBuffer)比較兩個(gè)緩沖區(qū)是否相等享钞,如果是返回 true,否則返回 false诀蓉。
<li>buf.compare(otherBuffer)比較兩個(gè) Buffer 對(duì)象栗竖,返回一個(gè)數(shù)字,表示 buf 在 otherBuffer 之前渠啤,之后或相同纠脾。
<li>buf.copy(targetBuffer[, targetStart[, sourceStart[, sourceEnd]]])buffer 拷貝得哆,源和目標(biāo)可以相同入桂。 targetStart 目標(biāo)開(kāi)始偏移和 sourceStart 源開(kāi)始偏移默認(rèn)都是 0婚肆。 sourceEnd 源結(jié)束位置偏移默認(rèn)是源的長(zhǎng)度 buffer.length 。
<li>buf.slice([start[, end]])剪切 Buffer 對(duì)象妓美,根據(jù) start(默認(rèn)是 0 ) 和 end (默認(rèn)是 buffer.length ) 偏移和裁剪了索引僵腺。 負(fù)的索引是從 buffer 尾部開(kāi)始計(jì)算的。
<li>buf.readUInt8(offset[, noAssert])根據(jù)指定的偏移量壶栋,讀取一個(gè)無(wú)符號(hào) 8 位整數(shù)辰如。若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)。 如果這樣 offset 可能會(huì)超出buffer 的末尾贵试。默認(rèn)是 false琉兜。
<li>buf.readUInt16LE(offset[, noAssert])根據(jù)指定的偏移量,使用特殊的 endian 字節(jié)序格式讀取一個(gè)無(wú)符號(hào) 16 位整數(shù)锡移。若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)。 這意味著 offset 可能會(huì)超出 buffer 的末尾漆际。默認(rèn)是 false淆珊。
<li>buf.readUInt16BE(offset[, noAssert])根據(jù)指定的偏移量,使用特殊的 endian 字節(jié)序格式讀取一個(gè)無(wú)符號(hào) 16 位整數(shù)奸汇,大端對(duì)齊施符。若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)往声。 這意味著 offset 可能會(huì)超出 buffer 的末尾。默認(rèn)是 false戳吝。
<li>buf.readUInt32LE(offset[, noAssert])根據(jù)指定的偏移量浩销,使用指定的 endian 字節(jié)序格式讀取一個(gè)無(wú)符號(hào) 32 位整數(shù),小端對(duì)齊听哭。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)慢洋。 這意味著 offset 可能會(huì)超出buffer 的末尾。默認(rèn)是 false陆盘。
<li>buf.readUInt32BE(offset[, noAssert])根據(jù)指定的偏移量普筹,使用指定的 endian 字節(jié)序格式讀取一個(gè)無(wú)符號(hào) 32 位整數(shù),大端對(duì)齊隘马。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)太防。 這意味著 offset 可能會(huì)超出buffer 的末尾。默認(rèn)是 false酸员。
<li>buf.readInt8(offset[, noAssert])根據(jù)指定的偏移量蜒车,讀取一個(gè)有符號(hào) 8 位整數(shù)。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)幔嗦。 這意味著 offset 可能會(huì)超出 buffer 的末尾酿愧。默認(rèn)是 false。
<li>buf.readInt16LE(offset[, noAssert])根據(jù)指定的偏移量崭添,使用特殊的 endian 格式讀取一個(gè) 有符號(hào) 16 位整數(shù)寓娩,小端對(duì)齊。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)呼渣。 這意味著 offset 可能會(huì)超出 buffer 的末尾棘伴。默認(rèn)是 false。
<li>buf.readInt16BE(offset[, noAssert])根據(jù)指定的偏移量屁置,使用特殊的 endian 格式讀取一個(gè) 有符號(hào) 16 位整數(shù)焊夸,大端對(duì)齊。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)蓝角。 這意味著 offset 可能會(huì)超出 buffer 的末尾阱穗。默認(rèn)是 false。
<li>buf.readInt32LE(offset[, noAssert])根據(jù)指定的偏移量使鹅,使用指定的 endian 字節(jié)序格式讀取一個(gè)有符號(hào) 32 位整數(shù)揪阶,小端對(duì)齊。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)患朱。 這意味著 offset 可能會(huì)超出buffer 的末尾鲁僚。默認(rèn)是 false。
<li>buf.readInt32BE(offset[, noAssert])根據(jù)指定的偏移量,使用指定的 endian 字節(jié)序格式讀取一個(gè)有符號(hào) 32 位整數(shù)冰沙,大端對(duì)齊侨艾。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)。 這意味著 offset 可能會(huì)超出buffer 的末尾拓挥。默認(rèn)是 false唠梨。
<li>buf.readFloatLE(offset[, noAssert])根據(jù)指定的偏移量,使用指定的 endian 字節(jié)序格式讀取一個(gè) 32 位雙浮點(diǎn)數(shù)侥啤,小端對(duì)齊当叭。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)。 這意味著 offset 可能會(huì)超出buffer的末尾愿棋。默認(rèn)是 false科展。
<li>buf.readFloatBE(offset[, noAssert])根據(jù)指定的偏移量,使用指定的 endian 字節(jié)序格式讀取一個(gè) 32 位雙浮點(diǎn)數(shù)糠雨,大端對(duì)齊才睹。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)。 這意味著 offset 可能會(huì)超出buffer的末尾甘邀。默認(rèn)是 false琅攘。
<li>buf.readDoubleLE(offset[, noAssert])根據(jù)指定的偏移量,使用指定的 endian字節(jié)序格式讀取一個(gè) 64 位雙精度數(shù)松邪,小端對(duì)齊坞琴。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)。 這意味著 offset 可能會(huì)超出buffer 的末尾逗抑。默認(rèn)是 false剧辐。
<li>buf.readDoubleBE(offset[, noAssert])根據(jù)指定的偏移量,使用指定的 endian字節(jié)序格式讀取一個(gè) 64 位雙精度數(shù)邮府,大端對(duì)齊荧关。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)。 這意味著 offset 可能會(huì)超出buffer 的末尾褂傀。默認(rèn)是 false忍啤。
<li>buf.writeUInt8(value, offset[, noAssert])根據(jù)傳入的 offset 偏移量將 value 寫(xiě)入 buffer。注意:value 必須是一個(gè)合法的無(wú)符號(hào) 8 位整數(shù)仙辟。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 offset 偏移量參數(shù)同波。 這意味著 value 可能過(guò)大,或者 offset 可能會(huì)超出 buffer 的末尾從而造成 value 被丟棄叠国。 除非你對(duì)這個(gè)參數(shù)非常有把握未檩,否則不要使用。默認(rèn)是 false粟焊。
<li>buf.writeUInt16LE(value, offset[, noAssert])根據(jù)傳入的 offset 偏移量和指定的 endian 格式將 value 寫(xiě)入 buffer冤狡。注意:value 必須是一個(gè)合法的無(wú)符號(hào) 16 位整數(shù)校赤,小端對(duì)齊。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)筒溃。 這意味著 value 可能過(guò)大,或者 offset 可能會(huì)超出buffer的末尾從而造成 value 被丟棄沾乘。 除非你對(duì)這個(gè)參數(shù)非常有把握怜奖,否則盡量不要使用。默認(rèn)是 false翅阵。
<li>buf.writeUInt16BE(value, offset[, noAssert])根據(jù)傳入的 offset 偏移量和指定的 endian 格式將 value 寫(xiě)入 buffer歪玲。注意:value 必須是一個(gè)合法的無(wú)符號(hào) 16 位整數(shù),大端對(duì)齊掷匠。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)滥崩。 這意味著 value 可能過(guò)大,或者 offset 可能會(huì)超出buffer的末尾從而造成 value 被丟棄讹语。 除非你對(duì)這個(gè)參數(shù)非常有把握钙皮,否則盡量不要使用。默認(rèn)是 false顽决。
<li>buf.writeUInt32LE(value, offset[, noAssert])根據(jù)傳入的 offset 偏移量和指定的 endian 格式(LITTLE-ENDIAN:小字節(jié)序)將 value 寫(xiě)入buffer短条。注意:value 必須是一個(gè)合法的無(wú)符號(hào) 32 位整數(shù),小端對(duì)齊才菠。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)茸时。 這意味著value 可能過(guò)大,或者offset可能會(huì)超出buffer的末尾從而造成 value 被丟棄赋访。 除非你對(duì)這個(gè)參數(shù)非常有把握可都,否則盡量不要使用。默認(rèn)是 false蚓耽。
<li>buf.writeUInt32BE(value, offset[, noAssert])根據(jù)傳入的 offset 偏移量和指定的 endian 格式(Big-Endian:大字節(jié)序)將 value 寫(xiě)入buffer渠牲。注意:value 必須是一個(gè)合法的有符號(hào) 32 位整數(shù)。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)田晚。 這意味著 value 可能過(guò)大嘱兼,或者offset可能會(huì)超出buffer的末尾從而造成 value 被丟棄。 除非你對(duì)這個(gè)參數(shù)非常有把握贤徒,否則盡量不要使用芹壕。默認(rèn)是 false。
<li>buf.writeInt8(value, offset[, noAssert])
<li>buf.writeInt16LE(value, offset[, noAssert])根據(jù)傳入的 offset 偏移量和指定的 endian 格式將 value 寫(xiě)入 buffer接奈。注意:value 必須是一個(gè)合法的 signed 16 位整數(shù)踢涌。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)。 這意味著 value 可能過(guò)大序宦,或者 offset 可能會(huì)超出 buffer 的末尾從而造成 value 被丟棄睁壁。 除非你對(duì)這個(gè)參數(shù)非常有把握,否則盡量不要使用。默認(rèn)是 false 潘明。
<li>buf.writeInt16BE(value, offset[, noAssert])根據(jù)傳入的 offset 偏移量和指定的 endian 格式將 value 寫(xiě)入 buffer行剂。注意:value 必須是一個(gè)合法的 signed 16 位整數(shù)。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)钳降。 這意味著 value 可能過(guò)大厚宰,或者 offset 可能會(huì)超出 buffer 的末尾從而造成 value 被丟棄。 除非你對(duì)這個(gè)參數(shù)非常有把握遂填,否則盡量不要使用铲觉。默認(rèn)是 false 。
<li>buf.writeInt32LE(value, offset[, noAssert])根據(jù)傳入的 offset 偏移量和指定的 endian 格式將 value 寫(xiě)入 buffer吓坚。注意:value 必須是一個(gè)合法的 signed 32 位整數(shù)撵幽。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)。 這意味著 value 可能過(guò)大礁击,或者 offset 可能會(huì)超出 buffer 的末尾從而造成 value 被丟棄盐杂。 除非你對(duì)這個(gè)參數(shù)非常有把握,否則盡量不要使用哆窿。默認(rèn)是 false况褪。
<li>buf.writeInt32BE(value, offset[, noAssert])根據(jù)傳入的 offset 偏移量和指定的 endian 格式將 value 寫(xiě)入 buffer。注意:value 必須是一個(gè)合法的 signed 32 位整數(shù)更耻。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)测垛。 這意味著 value 可能過(guò)大,或者 offset 可能會(huì)超出 buffer 的末尾從而造成 value 被丟棄秧均。 除非你對(duì)這個(gè)參數(shù)非常有把握食侮,否則盡量不要使用。默認(rèn)是 false目胡。
<li>buf.writeFloatLE(value, offset[, noAssert])根據(jù)傳入的 offset 偏移量和指定的 endian 格式將 value 寫(xiě)入 buffer 锯七。注意:當(dāng) value 不是一個(gè) 32 位浮點(diǎn)數(shù)類型的值時(shí),結(jié)果將是不確定的誉己。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)眉尸。 這意味著 value可能過(guò)大,或者 offset 可能會(huì)超出 buffer 的末尾從而造成 value 被丟棄巨双。 除非你對(duì)這個(gè)參數(shù)非常有把握噪猾,否則盡量不要使用。默認(rèn)是 false筑累。
<li>buf.writeFloatBE(value, offset[, noAssert])根據(jù)傳入的 offset 偏移量和指定的 endian 格式將 value 寫(xiě)入 buffer 袱蜡。注意:當(dāng) value 不是一個(gè) 32 位浮點(diǎn)數(shù)類型的值時(shí),結(jié)果將是不確定的慢宗。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)坪蚁。 這意味著 value可能過(guò)大奔穿,或者 offset 可能會(huì)超出 buffer 的末尾從而造成 value 被丟棄。 除非你對(duì)這個(gè)參數(shù)非常有把握敏晤,否則盡量不要使用贱田。默認(rèn)是 false。
<li>buf.writeDoubleLE(value, offset[, noAssert])根據(jù)傳入的 offset 偏移量和指定的 endian 格式將 value 寫(xiě)入 buffer嘴脾。注意:value 必須是一個(gè)有效的 64 位double 類型的值湘换。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)。 這意味著 value 可能過(guò)大统阿,或者 offset 可能會(huì)超出 buffer 的末尾從而造成value被丟棄。 除非你對(duì)這個(gè)參數(shù)非常有把握筹我,否則盡量不要使用扶平。默認(rèn)是 false。
<li>buf.writeDoubleBE(value, offset[, noAssert])根據(jù)傳入的 offset 偏移量和指定的 endian 格式將 value 寫(xiě)入 buffer蔬蕊。注意:value 必須是一個(gè)有效的 64 位double 類型的值结澄。 若參數(shù) noAssert 為 true 將不會(huì)驗(yàn)證 value 和 offset 偏移量參數(shù)。 這意味著 value 可能過(guò)大岸夯,或者 offset 可能會(huì)超出 buffer 的末尾從而造成value被丟棄。 除非你對(duì)這個(gè)參數(shù)非常有把握猜扮,否則盡量不要使用。默認(rèn)是 false旅赢。
<li>buf.fill(value[, offset][, end])使用指定的 value 來(lái)填充這個(gè) buffer。如果沒(méi)有指定 offset (默認(rèn)是 0) 并且 end (默認(rèn)是 buffer.length) 煮盼,將會(huì)填充整個(gè)buffer。