Node.js<三>

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。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末僵控,一起剝皮案震驚了整個(gè)濱河市香到,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌报破,老刑警劉巖悠就,帶你破解...
    沈念sama閱讀 206,602評(píng)論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異充易,居然都是意外死亡理卑,警方通過(guò)查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,442評(píng)論 2 382
  • 文/潘曉璐 我一進(jìn)店門(mén)蔽氨,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)藐唠,“玉大人帆疟,你說(shuō)我怎么就攤上這事∮盍ⅲ” “怎么了踪宠?”我有些...
    開(kāi)封第一講書(shū)人閱讀 152,878評(píng)論 0 344
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)妈嘹。 經(jīng)常有香客問(wèn)我柳琢,道長(zhǎng),這世上最難降的妖魔是什么润脸? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 55,306評(píng)論 1 279
  • 正文 為了忘掉前任柬脸,我火速辦了婚禮,結(jié)果婚禮上毙驯,老公的妹妹穿的比我還像新娘倒堕。我一直安慰自己,他們只是感情好爆价,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,330評(píng)論 5 373
  • 文/花漫 我一把揭開(kāi)白布垦巴。 她就那樣靜靜地躺著,像睡著了一般铭段。 火紅的嫁衣襯著肌膚如雪骤宣。 梳的紋絲不亂的頭發(fā)上,一...
    開(kāi)封第一講書(shū)人閱讀 49,071評(píng)論 1 285
  • 那天序愚,我揣著相機(jī)與錄音憔披,去河邊找鬼。 笑死爸吮,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的蔗候。 我是一名探鬼主播锈遥,決...
    沈念sama閱讀 38,382評(píng)論 3 400
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼勘畔,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來(lái)了爬立?” 一聲冷哼從身側(cè)響起侠驯,我...
    開(kāi)封第一講書(shū)人閱讀 37,006評(píng)論 0 259
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎儒士,沒(méi)想到半個(gè)月后着撩,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體匾委,經(jīng)...
    沈念sama閱讀 43,512評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡薯鳍,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 35,965評(píng)論 2 325
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了采章。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片悯舟。...
    茶點(diǎn)故事閱讀 38,094評(píng)論 1 333
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡奋救,死狀恐怖反惕,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情背亥,我是刑警寧澤狡汉,帶...
    沈念sama閱讀 33,732評(píng)論 4 323
  • 正文 年R本政府宣布盾戴,位于F島的核電站尖啡,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏沿癞。R本人自食惡果不足惜矛渴,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,283評(píng)論 3 307
  • 文/蒙蒙 一蚕涤、第九天 我趴在偏房一處隱蔽的房頂上張望揖铜。 院中可真熱鬧达皿,春花似錦、人聲如沸龄寞。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 30,286評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)科阎。三九已至忿族,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間票唆,已是汗流浹背屹徘。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 31,512評(píng)論 1 262
  • 我被黑心中介騙來(lái)泰國(guó)打工簿煌, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人惩琉。 一個(gè)月前我還...
    沈念sama閱讀 45,536評(píng)論 2 354
  • 正文 我出身青樓瞒渠,卻偏偏與公主長(zhǎng)得像伍玖,于是被迫代替她去往敵國(guó)和親剿吻。 傳聞我的和親對(duì)象是個(gè)殘疾皇子椰棘,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,828評(píng)論 2 345

推薦閱讀更多精彩內(nèi)容