Node.js Buffer (tampón)

JavaScript lenguaje mismo únicos tipos de datos de cadena, ningún tipo de datos binarios.

Pero cuando se trata de corrientes como flujo TCP o archivo, debe utilizar los datos binarios. Por lo tanto, en Node.js, la definición de una clase de búfer que se utiliza para crear un tampón de almacenamiento especializado datos binarios.

En los Node.js, clase Buffer se libera junto con la biblioteca central del núcleo de nodo. biblioteca tampón Node.js aporta un método de almacenamiento de datos en bruto permite Node.js manejar datos binarios, cada vez que se necesita para manejar las operaciones de E / S para mover datos Node.js cuando es posible usar la biblioteca tampón . Los datos originales almacenados en la clase Buffer instancia. Un búfer es similar a una matriz de enteros, pero corresponde a una memoria prima fuera del montón V8.

Crear clase Buffer

clase Buffer Node se puede crear de varias maneras.

Método 1

Crear ejemplo una longitud de 10 bytes Buffer:

var buf = new Buffer(10);

Método 2

A través de una creación de la matriz dada Buffer Ejemplo:

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

Método 3

Crear instancia de búfer por una cadena:

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

UTF-8 es la codificación predeterminada, además también es compatible con las siguientes codificaciones: "ascii", "UTF-8", "utf16le", "ucs2", "base 64" y "hexagonal".

buffer de escritura

gramática

sintaxis buffer de escritura de nodo es el siguiente:

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

parámetros

Los parámetros se describen a continuación:

• String - El búfer de cadena está escrito.

• compensado - el búfer de índice para empezar a escribir, el valor predeterminado es 0.

• longitud - el número de bytes escritos, por defecto buffer.length

• codificación - la codificación utilizada.El valor por defecto es 'UTF-8'.

Valor de retorno

Devuelve el tamaño de la escritura real. Si el espacio de memoria intermedia, la única porción de la cadena está escrito.

Ejemplos

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

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

Aplicación del código anterior, la salida es:

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

Lee datos de la memoria intermedia

gramática

sintaxis de datos de búfer de lectura de nodo es el siguiente:

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

parámetros

Los parámetros se describen a continuación:

• codificación - la codificación utilizada.El valor por defecto es 'UTF-8'.

• Inicio - inicia la lectura de posición del índice especifica, el valor predeterminado es 0.

• final - la posición final, el valor predeterminado es el final del búfer.

Valor de retorno

La decodificación de los datos de amortiguamiento y devuelve una cadena utilizando la codificación especificada.

Ejemplos

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

Aplicación del código anterior, la salida es:

$ node main.js
abcdefghijklmnopqrstuvwxyz
abcde
abcde
abcde

Tampón se convierte en un objeto JSON

gramática

La sintaxis de la función de nodo objeto Buffer en JSON es la siguiente:

buf.toJSON()

Valor de retorno

Devuelve objeto JSON.

Ejemplos

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

console.log(json);

Aplicación del código anterior, la salida es:

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

Combinar tampón

gramática

tampón Nodo sintaxis combinada es la siguiente:

Buffer.concat(list[, totalLength])

parámetros

Los parámetros se describen a continuación:

• Lista - una matriz de objetos de lista combinada de búfer.

• totalLength - después de una longitud combinada total especificado del objeto Buffer.

Valor de retorno

Devolver varios miembros de un nuevo objeto Buffer fusionada.

Ejemplos

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

Aplicación del código anterior, la salida es:

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

Comparación tampón

gramática

Nodo Buffer comparar sintaxis de la función es el siguiente, el método introducido en la versión v0.12.2 Node.js:

buf.compare(otherBuffer);

parámetros

Los parámetros se describen a continuación:

• otherBuffer - en comparación con el buffer bufobjetos a otro objeto.

Valor de retorno

Devuelve un número que representabuf antes otherBuffer,o después de la misma.

Ejemplos

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

Aplicación del código anterior, la salida es:

ABC在ABCD之前

búfer de copia

gramática

sintaxis Nodo copia tampón es la siguiente:

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

parámetros

Los parámetros se describen a continuación:

• targetBuffer - Buffer objetos que desea copiar.

• targetStart - digital, opcional, por defecto: 0

• sourceStart - digital, opcional, por defecto: 0

• sourceEnd - digital, opcional, por defecto: buffer.length

Valor de retorno

Se desconoce el valor de retorno.

Ejemplos

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

Aplicación del código anterior, la salida es:

buffer2 content: ABC

Buffer de cultivos

sintaxis Nodo tampón de cultivos es la siguiente:

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

parámetros

Los parámetros se describen a continuación:

• empezar - números, opcional, por defecto: 0

• final - digital, opcional, por defecto: buffer.length

Valor de retorno

Devuelve un nuevo buffer, es viejo y apuntan a la misma pieza de búfer de memoria, pero se empieza desde el índice a la ubicación del extremo cortado.

Ejemplos

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

Aplicación del código anterior, la salida es:

buffer2 content: ru

longitud del búfer

gramática

tampón Nodo sintaxis cálculo de la longitud es la siguiente:

buf.length;

Valor de retorno

Copias de la memoria búfer ocupado por la longitud del objeto.

Ejemplos

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

Aplicación del código anterior, la salida es:

buffer length: 14

Manual de Referencia de los métodos

A continuación se presenta un módulo de Node.js Buffer lista método comúnmente utilizado (Tenga en cuenta que algunos métodos en la versión antigua no es):

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