Node.jsのバッファ（バッファ）

JavaScriptの言語自体のみ文字列データ型、無バイナリデータ型。

TCPストリームやファイルなどのストリームを扱う場合でも、あなたはバイナリデータを使用する必要があります。 したがって、Node.jsの、特殊なストレージバッファバイナリデータを作成するために使用されるバッファクラスの定義です。

Node.jsでは、バッファクラスは、ノードカーネルコアライブラリと一緒に放出されます。 バッファNode.jsのライブラリを使用して、バッファのライブラリーを使用することが可能である場合、データのNode.jsを移動するためにI / O操作を処理する必要があるたびに、生データ格納方法は、Node.jsのバイナリデータを扱うことができます。 元のデータは、例えばバッファ・クラスに格納されています。 バッファは、整数の配列に似ていますが、V8ヒープ外生のメモリに対応しています。

バッファクラスを作成します。

ノードバッファクラスは、いくつかの方法で作成することができます。

方法1

インスタンスに10バイトのバッファの長さを作成します。

var buf = new Buffer(10);

方法2

指定された配列の作成バッファー例を通して：

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

方法3

文字列によってバッファインスタンスを作成します。

var buf = new Buffer("www.w3big.com", "utf-8");

UTF-8に加えて、それはまた次のエンコーディングをサポートして、デフォルトのエンコーディングです： "アスキー"、 "UTF8"、 "utf16le"、 "UCS2"、 "base64で」と「六角」。

書き込みバッファー

文法

次のようにノード書き込みバッファの構文は次のとおりです。

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

パラメータ

パラメータは以下の通りであります：

• 文字列-文字列バッファが書き込まれます。

• オフセット-書き込みを開始するインデックスバッファを、デフォルトは0です。

• 長さ-書き込まれたバイト数、デフォルトのbuffer.lengthによって

• エンコード-使用するエンコーディング。デフォルトは 'UTF8'です。

戻り値

実際の書き込みのサイズを返します。 バッファ空間場合、文字列の一部のみが書き込まれます。

例

buf = new Buffer(256);
len = buf.write("www.w3big.com");

console.log("写入字节数 : "+  len);

上記のコードの実装、出力は次のようになります。

$node main.js
写入字节数 : 14

バッファからデータを読み込み

文法

次のようにノードの読み取りバッファデータの構文は次のとおりです。

buf.toString([encoding[, start[, end]]])

パラメータ

パラメータは以下の通りであります：

• エンコード-使用するエンコーディング。デフォルトは 'UTF8'です。

• 起動-指定したインデックス位置の読み取りを開始、デフォルトは0です。

• エンド-エンドの位置は、デフォルトでは、バッファの最後です。

戻り値

バッファデータをデコードし、指定されたエンコーディングを使用して文字列を返します。

例

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

上記のコードの実装、出力は次のようになります。

$ node main.js
abcdefghijklmnopqrstuvwxyz
abcde
abcde
abcde

バッファは、JSONオブジェクトに変換されます

文法

次のようにノードのバッファJSONにオブジェクト関数の構文は次のとおりです。

buf.toJSON()

戻り値

JSONオブジェクトを返します。

例

var buf = new Buffer('www.w3big.com');
var json = buf.toJSON(buf);

console.log(json);

上記のコードの実装、出力は次のようになります。

[ 119, 119, 119, 46, 114, 117, 110, 111, 111, 98, 46, 99, 111, 109 ]

バッファ・マージ

文法

次のようにノードバッファ組み合わせる構文は次のとおりです。

Buffer.concat(list[, totalLength])

パラメータ

パラメータは以下の通りであります：

• リスト-バッファ組み合わされたリストのためのオブジェクトの配列。

• totalLength -バッファオブジェクトの指定された合計した長さの後に。

戻り値

マージされた新しいバッファオブジェクトの複数のメンバーを返します。

例

var buffer1 = new Buffer('本教程 ');
var buffer2 = new Buffer('www.w3big.com');
var buffer3 = Buffer.concat([buffer1,buffer2]);
console.log("buffer3 内容: " + buffer3.toString());

上記のコードの実装、出力は次のようになります。

buffer3 内容: 本教程 www.w3big.com

比較バッファ

文法

ノードのバッファは、関数の構文を比較し、以下のように、Node.jsのv0.12.2バージョンで導入されたメソッドです。

buf.compare(otherBuffer);

パラメータ

パラメータは以下の通りであります：

• otherBuffer -別のオブジェクトへのbufのバッファオブジェクトと比較。

戻り値

それはotherBuffer前、または同じ後はbufを表す数値を返します。

例

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 + "之后");
}

上記のコードの実装、出力は次のようになります。

ABC在ABCD之前

コピーバッファ

文法

次のようにノードのバッファコピーの構文は次のとおりです。

buf.copy(targetBuffer[, targetStart[, sourceStart[, sourceEnd]]])

パラメータ

パラメータは以下の通りであります：

• targetBuffer -バッファは、コピーしたいオブジェクト。

• targetStart -デジタル、オプション、デフォルト：0

• sourceStartで-デジタル、オプション、デフォルト：0

• sourceEnd -デジタル、オプション、デフォルト：buffer.length

戻り値

戻り値なし。

例

var buffer1 = new Buffer('ABC');
// 拷贝一个缓冲区
var buffer2 = new Buffer(3);
buffer1.copy(buffer2);
console.log("buffer2 content: " + buffer2.toString());

上記のコードの実装、出力は次のようになります。

buffer2 content: ABC

クロップバッファ

次のようにノードのバッファ作物の構文は次のとおりです。

buf.slice([start[, end]])

パラメータ

パラメータは以下の通りであります：

• スタート-番号、オプション、デフォルト：0

• エンド-デジタル、オプション、デフォルト：buffer.length

戻り値

新しいバッファを返し、それはメモリバッファの同じ部分に古いとポイントですが、切り口の場所にインデックスから開始します。

例

var buffer1 = new Buffer('w3big');
// 剪切缓冲区
var buffer2 = buffer1.slice(0,2);
console.log("buffer2 content: " + buffer2.toString());

上記のコードの実装、出力は次のようになります。

buffer2 content: ru

バッファ長

文法

次のようにノードのバッファ長計算の構文は次のとおりです。

buf.length;

戻り値

バックバッファメモリは、オブジェクトの長さによって占められます。

例

var buffer = new Buffer('www.w3big.com');
//  缓冲区长度
console.log("buffer length: " + buffer.length);

上記のコードの実装、出力は次のようになります。

buffer length: 14

メソッドリファレンス・マニュアル

以下のリストNode.jsのバッファモジュールに一般的に使用される方法（古いバージョンではいくつかの方法がないことに注意してください）です。

var b = new Buffer(6);
b.writeUIntBE(0x1234567890ab, 0, 6);
// <Buffer 12 34 56 78 90 ab>