Node.js Buffer (Puffer)

JavaScript Sprache selbst nur String-Datentypen, keine binären Datentyp.

Aber, wenn sie mit Strömen wie TCP-Stream oder eine Datei handelt, müssen Sie die binären Daten verwenden. Daher wird in Node.js die Definition einer Pufferklasse, die verwendet wird, um eine spezielle Speicherpuffer Binärdaten zu erzeugen.

In den Node.js wird Buffer-Klasse freigegeben zusammen mit der Core-Bibliothek Node-Kernel. Buffer Node.js Bibliothek bringt eine Speicherung von Rohdaten-Methode ermöglicht es Node.js binäre Daten verarbeiten, wenn Sie I / O-Operationen behandeln müssen Daten zu bewegen Node.js, wenn es möglich ist, Buffer-Bibliothek verwenden . Die Originaldaten in der Instanz Buffer-Klasse gespeichert. Ein Puffer ist ähnlich zu einem Array von ganzen Zahlen, aber es entspricht einem rohen Speicher außerhalb des V8 Heap.

Erstellen Sie Buffer-Klasse

Knoten Buffer Klasse kann auf verschiedene Weise erzeugt werden.

Methode 1

Erstellen Sie zB eine Länge von 10 Byte Puffer:

var buf = new Buffer(10);

Methode 2

Durch eine gegebene Array-Erstellung Buffer Beispiel:

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

Methode 3

Erstellen Sie Buffer-Instanz durch einen String:

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

utf-8 ist die Standard-Kodierung, zusätzlich unterstützt es auch die folgenden Codierungen: "ascii", "UTF-8", "Utf16LE", "ucs2", "base64" und "hex".

Schreibpuffer

Grammatik

Knoten Schreibpuffer Syntax lautet wie folgt:

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

Parameter

Parameter werden im Folgenden beschrieben:

• String - Der String - Puffer geschrieben wird.

• Offset - der Indexpuffer Schreiben beginnen, ist der Standardwert 0.

• Länge - die Anzahl der geschriebenen Bytes, die standardmäßig buffer.length

• Codierung - die Codierung verwendet.Der Standardwert ist "UTF-8".

Rückgabewert

Gibt die Größe des eigentlichen Schreibens. Wenn der Pufferspeicher ist der einzige Teil des Strings geschrieben.

Beispiele

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

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

Die Umsetzung des obigen Codes ist die Ausgabe:

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

Liest Daten aus dem Puffer

Grammatik

Knoten Lesepuffer Datensyntax ist wie folgt:

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

Parameter

Parameter werden im Folgenden beschrieben:

• Codierung - die Codierung verwendet.Der Standardwert ist "UTF-8".

• Start - Start angegebenen Indexposition zu lesen, ist der Standardwert 0.

• Ende - der Endposition ist der Standard das Ende des Puffers.

Rückgabewert

Das Dekodieren Pufferdaten und gibt eine Zeichenfolge die angegebene Codierung.

Beispiele

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

Die Umsetzung des obigen Codes ist die Ausgabe:

$ node main.js
abcdefghijklmnopqrstuvwxyz
abcde
abcde
abcde

Puffer wird zu einem JSON-Objekt umgewandelt werden

Grammatik

Der Knotenpuffer in JSON-Objekt-Funktion Syntax lautet wie folgt:

buf.toJSON()

Rückgabewert

Gibt JSON-Objekt.

Beispiele

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

console.log(json);

Die Umsetzung des obigen Codes ist die Ausgabe:

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

Buffer Merge

Grammatik

Knoten Puffer kombiniert Syntax lautet wie folgt:

Buffer.concat(list[, totalLength])

Parameter

Parameter werden im Folgenden beschrieben:

• Liste - ein Array von Objekten für Buffer kombinierten Liste.

• totalLength - nach einer festgelegten kombinierten Gesamtlänge des Buffer - Objekt.

Rückgabewert

Return mehrere Mitglieder eines fusionierten neuen Buffer-Objekt.

Beispiele

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

Die Umsetzung des obigen Codes ist die Ausgabe:

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

Vergleichspuffer

Grammatik

Knoten Buffer Vergleichsfunktion Syntax ist wie folgt, wobei das Verfahren in Node.js v0.12.2 Version eingeführt:

buf.compare(otherBuffer);

Parameter

Parameter werden im Folgenden beschrieben:

• otherBuffer - verglichen mit bufBuffer - Objekte auf ein anderes Objekt.

Rückgabewert

Es gibt eine Zahl , diebuf vor otherBufferoder nach derselben darstellt.

Beispiele

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

Die Umsetzung des obigen Codes ist die Ausgabe:

ABC在ABCD之前

Kopieren Puffer

Grammatik

Knoten Pufferkopie Syntax lautet wie folgt:

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

Parameter

Parameter werden im Folgenden beschrieben:

• targetBuffer - Puffer Objekte , die Sie kopieren möchten.

• targetStart - digital, optional, default: 0

• sourceStart - digital, optional, default: 0

• sourceEnd - digital, optional, default: buffer.length

Rückgabewert

Kein Rückgabewert.

Beispiele

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

Die Umsetzung des obigen Codes ist die Ausgabe:

buffer2 content: ABC

Crop Buffer

Knoten Pufferernte Syntax lautet wie folgt:

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

Parameter

Parameter werden im Folgenden beschrieben:

• Start - Zahlen, optional, default: 0

• Ende - digital, optional, default: buffer.length

Rückgabewert

Gibt einen neuen Puffer, ist es alt und auf dasselbe Stück des Speicherpuffers, aber ab dem Index zu der Stelle des Schnittendes.

Beispiele

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

Die Umsetzung des obigen Codes ist die Ausgabe:

buffer2 content: ru

Pufferlänge

Grammatik

Knoten Pufferlänge Berechnung Syntax lautet wie folgt:

buf.length;

Rückgabewert

Back-Buffer-Speicher durch die Objektlänge besetzt.

Beispiele

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

Die Umsetzung des obigen Codes ist die Ausgabe:

buffer length: 14

Methode Referenzhandbuch

Es folgt eine Liste Node.js Puffermodul häufig verwendete Methode (Beachten Sie, dass einige Methoden in der alten Version nicht ist):

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