Node.jsバッファ

JavaScript 言語自体には文字列データ型のみがあり、バイナリデータ型はありません。

ただし、TCP やファイル ストリームなどのストリームを処理する場合は、バイナリ データを使用する必要があります。そのため、Node.js では、バイナリ データを格納するための専用のバッファ領域を作成するために使用される Buffer クラスが定義されています。

Node.js では、Buffer クラスは Node カーネルとともにリリースされるコア ライブラリです。バッファ ライブラリは、生データを Node.js に保存する方法を提供し、Node.js での I/O 操作中に移動されたデータを処理する必要があるときはいつでも、Node.js でバッファ ライブラリを使用できるようにします。 。生データは Buffer クラスのインスタンスに保存されます。バッファは整数配列に似ていますが、V8 ヒープ メモリの外側にある生のメモリの一部に対応します。

Buffer クラスの作成

Node Buffer クラスはさまざまな方法で作成できます。

方法 1

長さ 10 バイトの Buffer インスタンスを作成する:

var buf = new Buffer(10);

方法 2

指定された配列から Buffer インスタンスを作成する:

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

方法 3

文字列から Buffer インスタンスを作成する:

var buf = new Buffer("www.php.cn", "utf-8");

utf-8 はデフォルトのエンコードで、「ascii」、「utf8」、「utf16le」、「ucs2」、「base64」、「hex」のエンコードもサポートしています。

バッファの書き込み

構文

ノード バッファを書き込むための構文は次のとおりです:

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

パラメータ

パラメータは次のように説明されます:

• string - バッファに書き込む文字列。

• offset - バッファへの書き込みが開始されるインデックス値、デフォルトは 0 です。

• length - 書き込まれたバイト数、デフォルトはbuffer.length

• encoding - 使用されるエンコーディング。デフォルトは 'utf8' です。

戻り値

実際に書き込まれたサイズを返します。バッファスペースが不十分な場合は、文字列の一部のみが書き込まれます。

インスタンス

buf = new Buffer(256);
len = buf.write("www.php.cn");

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

上記のコードを実行すると、出力結果は次のようになります:

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

バッファからデータを読み取ります

構文

ノードバッファデータを読み取るための構文は次のとおりです:

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

パラメータ

パラメータは次のとおりです:次のように説明します:

• encoding - 使用されるエンコーディング。デフォルトは 'utf8' です。

• start - 読み取りを開始するインデックス位置を指定します。デフォルトは 0 です。

• end - 終了位置、デフォルトはバッファの末尾です。

戻り値

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

Instance

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.php.cn');
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])

パラメータ

パラメータは次のように説明されます:

• list - マージ用の Buffer オブジェクトの配列リスト。

• totalLength - マージされた Buffer オブジェクトの合計の長さを指定します。

戻り値

複数のメンバーを結合した新しい Buffer オブジェクトを返します。

例

var buffer1 = new Buffer('php中文网 ');
var buffer2 = new Buffer('www.php.cn');
var buffer3 = Buffer.concat([buffer1,buffer2]);
console.log("buffer3 内容: " + buffer3.toString());

上記のコードを実行すると、出力結果は次のようになります:

buffer3 内容: php中文网 www.php.cn

バッファ比較

構文

ノードバッファ比較の関数構文は次のとおりです。このメソッドはNode.js v0.12.2バージョンで導入されました。 :

buf.compare(otherBuffer);

Parameters

パラメータは次のように記述されます:

• otherBuffer - buf オブジェクトと比較される別の Buffer オブジェクト。

戻り値

bufがotherBufferの前、後、または同じであることを示す数値を返します。

例

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 - コピーされる Buffer オブジェクト。

• 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

• end

  - 数値、オプション、デフォルト:buffer.length

戻り値

古いバッファと同じメモリを指す新しいバッファを返します。ただし、インデックスの最初から最後までカットされます。

例

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

上記のコードを実行すると、出力結果は次のようになります:

buffer2 content: ru

構文

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

buf.length;

戻り値

バッファによって占有されているメモリを返しますオブジェクトの長さ。

例

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

上記のコードを実行すると、出力結果は次のようになります:

buffer length: 14

以下は、Node.jsバッファモジュールで一般的に使用されるメソッドのリストです(一部のメソッドはNode.jsバッファモジュールでは使用できないことに注意してください)古いバージョン):

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