9. 缓冲区

• 以下是创建10 个八位字节的无启动缓冲区的语法：

  var buf = new Buffer(10);
  

• 以下是从给定数组创建缓冲区的语法：

  var buf = new Buffer([10, 20, 30, 40, 50]);
  

• 以下是从给定字符串创建缓冲区的语法，并可选择编码类型：

  var buf = new Buffer("Simply Easy Learning", "utf-8");
  

• 语法：buf.write(string[, offset][, length][, encoding])
• 参数：
  • string ：这是要写入缓冲区的字符串数据。
  • offset ：这是开始写入的缓冲区的索引。 默认值为0。
  • length ：这是要写入的字节数。 默认为buffer.length。
  • encoding ：要使用的编码。 ‘utf8’是默认编码。
• 返回值：此方法返回写入的八位字节数。 如果缓冲区中没有足够的空间来容纳整个字符串，它将写入字符串的一部分。

buf = new Buffer(256);
len = buf.write("Simply Easy Learning");
console.log("Octets written : "+  len);

Octets written : 20

• 语法：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'));       // outputs: abcdefghijklmnopqrstuvwxyz
console.log( buf.toString('ascii',0,5));   // outputs: abcde
console.log( buf.toString('utf8',0,5));    // outputs: abcde
console.log( buf.toString(undefined,0,5)); // encoding defaults to 'utf8', outputs abcde

abcdefghijklmnopqrstuvwxyz
abcde
abcde
abcde

• 语法：buf.toJSON()
• 返回值：此方法返回Buffer实例的JSON表示形式。

var buf = new Buffer('Simply Easy Learning');
var json = buf.toJSON(buf);
console.log(json);

{ type: 'Buffer',
   data: 
   [ 
      83,
      105,
      109,
      112,
      108,
      121,
      32,
      69,
      97,
      115,
      121,
      32,
      76,
      101,
      97,
      114,
      110,
      105,
      110,
      103 
   ]
}

• 语法：Buffer.concat(list[, totalLength])
• 参数：
  • list ：要连接的Buffer对象的Array列表。
  • totalLength ：这是连接时缓冲区的总长度。
• 返回值：此方法返回Buffer实例。

var buffer1 = new Buffer('IoWiki ');
var buffer2 = new Buffer('Simply Easy Learning');
var buffer3 = Buffer.concat([buffer1,buffer2]);
console.log("buffer3 content: " + buffer3.toString());

• 语法：buf.compare(otherBuffer);
• 参数：
  • otherBuffer – 这是另一个与buf 进行比较的buf
• 返回值：返回一个数字，指示它是排在顺序之前还是之后，或者与排序顺序中的otherBuffer相同。

var buffer1 = new Buffer('ABC');
var buffer2 = new Buffer('ABCD');
var result = buffer1.compare(buffer2);
if(result < 0) {
   console.log(buffer1 +" comes before " + buffer2);
} else if(result === 0) {
   console.log(buffer1 +" is same as " + buffer2);
} else {
   console.log(buffer1 +" comes after " + buffer2);
}

• 语法：buf.copy(targetBuffer[, targetStart][, sourceStart][, sourceEnd])
• 参数：
  • targetBuffer – 缓冲区将被复制的缓冲区对象。
  • targetStart – Number，Optional，默认值:0
  • sourceStart – Number，Optional，默认值:0
  • sourceEnd – Number，Optional，默认值:buffer.length
• 返回值：没有回报价值。 即使目标存储器区域与源重叠，也要将数据从此缓冲区的区域复制到目标缓冲区中的区域。 如果未定义，则targetStart和sourceStart参数默认为0，而sourceEnd默认为buffer.length。

var buffer1 = new Buffer('ABC');
//copy a buffer
var buffer2 = new Buffer(3);
buffer1.copy(buffer2);
console.log("buffer2 content: " + buffer2.toString());

• 语法：buf.slice([start][, end])
• 参数：
  • start – Number，Optional，默认值:0
  • end – Number，Optional，默认值:buffer.length
• 返回值：返回一个新的缓冲区，该缓冲区引用与旧的内存相同的内存，但是由start（默认为0）和end（默认为buffer.length）索引进行偏移和裁剪。 负索引从缓冲区的末尾开始。

var buffer1 = new Buffer('IoWiki');
//slicing a buffer
var buffer2 = buffer1.slice(0,9);
console.log("buffer2 content: " + buffer2.toString());

• 语法：buf.length;
• 返回值：以字节为单位返回缓冲区的大小。

var buffer = new Buffer('IoWiki');
//length of the buffer
console.log("buffer length: " + buffer.length);