node.js中的buffer.write方法使用說明

更新時(shí)間：2014年12月10日 09:58:58 投稿：junjie

這篇文章主要介紹了node.js中的buffer.write方法使用說明,本文介紹了buffer.write的方法說明、語法、接收參數(shù)、使用實(shí)例和實(shí)現(xiàn)源碼,需要的朋友可以參考下

方法說明：

將string使用指定的encoding寫入到buffer的offset處。

返回寫入了多少個(gè)八進(jìn)制字節(jié)。

如果Buffer沒有足夠的空間來適應(yīng)整個(gè)string,那么將只有string的部分被寫入。

語法：

復(fù)制代碼代碼如下:

buffer.write(string, [offset], [length], [encoding])

接收參數(shù)：

string                  String,被寫入buffer的數(shù)據(jù).
offet                   number,可選,默認(rèn)0.數(shù)據(jù)寫入到buffer的位置.
length                Number,可選,默認(rèn):buffer.length – offset,要寫入數(shù)據(jù)的長(zhǎng)度
encoding           String,需要使用的編碼格式,可選,默認(rèn)為”utf8″.

例子：

復(fù)制代碼代碼如下:

buf = new Buffer(256);

len = buf.write('\u00bd + \u00bc = \u00be', 0);

console.log(len + " bytes: " + buf.toString('utf8', 0, len));

源碼：

復(fù)制代碼代碼如下:

Buffer.prototype.write = function(string, offset, length, encoding) {

  // allow write(string, encoding)

  if (util.isString(offset) && util.isUndefined(length)) {

    encoding = offset;

    offset = 0;

  // allow write(string, offset[, length], encoding)

  } else if (isFinite(offset)) {

    offset = ~~offset;

    if (isFinite(length)) {

      length = ~~length;

    } else {

      encoding = length;

      length = undefined;

    }

  // XXX legacy write(string, encoding, offset, length) - remove in v0.13

  } else {

    if (!writeWarned) {

      if (process.throwDeprecation)

        throw new Error(writeMsg);

      else if (process.traceDeprecation)

        console.trace(writeMsg);

      else

        console.error(writeMsg);

      writeWarned = true;

    }

    var swap = encoding;

    encoding = offset;

    offset = ~~length;

    length = swap;

  }

  var remaining = this.length - offset;

  if (util.isUndefined(length) || length > remaining)

    length = remaining;

  encoding = !!encoding ? (encoding + '').toLowerCase() : 'utf8';

  if (string.length > 0 && (length < 0 || offset < 0))

    throw new RangeError('attempt to write beyond buffer bounds');

  var ret;

  switch (encoding) {

    case 'hex':

      ret = this.hexWrite(string, offset, length);

      break;

    case 'utf8':

    case 'utf-8':

      ret = this.utf8Write(string, offset, length);

      break;

    case 'ascii':

      ret = this.asciiWrite(string, offset, length);

      break;

    case 'binary':

      ret = this.binaryWrite(string, offset, length);

      break;

    case 'base64':

      // Warning: maxLength not taken into account in base64Write

      ret = this.base64Write(string, offset, length);

      break;

    case 'ucs2':

    case 'ucs-2':

    case 'utf16le':

    case 'utf-16le':

      ret = this.ucs2Write(string, offset, length);

      break;

    default:

      throw new TypeError('Unknown encoding: ' + encoding);

  }

  return ret;

};