Buffer Node.js (tampon)

JavaScript langage lui-même seulement des types de données chaîne, aucun type de données binaires.

Mais lorsqu'ils traitent avec des flux comme flux TCP ou un fichier, vous devez utiliser les données binaires. Par conséquent, dans Node.js., la définition d'une classe tampon qui est utilisée pour créer un tampon de stockage spécialisé données binaires.

Dans les Node.js, classe Buffer est libéré en même temps que la bibliothèque de base du noyau Node. bibliothèque Buffer Node.js apporte une méthode de stockage de données brutes permet Node.js manipuler des données binaires, chaque fois que vous avez besoin pour gérer les opérations d'E / S pour déplacer des données Node.js quand il est possible d'utiliser la bibliothèque Buffer . Les données originales stockées dans l'instance de classe Buffer. Un tampon est similaire à un tableau d'entiers, mais elle correspond à une mémoire brute en dehors du tas de V8.

Créer la classe Buffer

classe noeud tampon peut être créé de plusieurs manières.

méthode 1

Créer une instance d'une longueur de 10 octets Buffer:

var buf = new Buffer(10);

méthode 2

Grâce à une création de tableau donné tampon Exemple:

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

méthode 3

Créer une instance tampon par une chaîne:

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

utf-8 est le codage par défaut, en outre, il prend également en charge les codages suivants: "ascii", "utf8", "utf16le", "ucs2", "base64" et "hex".

Ecrire un tampon

grammaire

syntaxe de mémoire tampon d'écriture du noeud est la suivante:

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

Paramètres

Les paramètres sont décrits ci-dessous:

• string - la mémoire tampon de chaîne est écrite.

• offset - le tampon d'index pour commencer à écrire, la valeur par défaut est 0.

• longueur - le nombre d'octets écrits, par buffer.Length par défaut

• encodage - le codage utilisé.La valeur par défaut est «utf8».

Valeur de retour

Renvoie la taille de l'écriture proprement dite. Si l'espace de mémoire tampon, la seule partie de la chaîne est écrite.

Exemples

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

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

Mise en œuvre du code ci-dessus, la sortie est:

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

Lit les données dans la mémoire tampon

grammaire

syntaxe de données de la mémoire tampon de lecture de nœud est le suivant:

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

Paramètres

Les paramètres sont décrits ci-dessous:

• encodage - le codage utilisé.La valeur par défaut est «utf8».

• commencer - commencer à lire la position d'index spécifiée, la valeur par défaut est 0.

• end - la position finale, la valeur par défaut est la fin de la mémoire tampon.

Valeur de retour

Décodage données de tampon et renvoie une chaîne en utilisant l'encodage spécifié.

Exemples

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

Mise en œuvre du code ci-dessus, la sortie est:

$ node main.js
abcdefghijklmnopqrstuvwxyz
abcde
abcde
abcde

Buffer sera converti en un objet JSON

grammaire

La syntaxe Node Buffer en JSON fonction de l'objet est le suivant:

buf.toJSON()

Valeur de retour

Renvoie l'objet JSON.

Exemples

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

console.log(json);

Mise en œuvre du code ci-dessus, la sortie est:

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

Buffer Merge

grammaire

syntaxe combinée de la mémoire tampon du noeud est la suivante:

Buffer.concat(list[, totalLength])

Paramètres

Les paramètres sont décrits ci-dessous:

• liste - un tableau d'objets de mémoire tampon liste combinée.

• totalLength - après une longueur combinée totale spécifiée de l'objet tampon.

Valeur de retour

Retour plusieurs membres d'un nouvel objet de mémoire tampon fusionnée.

Exemples

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

Mise en œuvre du code ci-dessus, la sortie est:

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

tampon Comparaison

grammaire

Node Buffer comparer la syntaxe de la fonction est la suivante, la méthode introduite dans la version de v0.12.2 Node.js:

buf.compare(otherBuffer);

Paramètres

Les paramètres sont décrits ci-dessous:

• otherBuffer - par rapport à bufobjets tampons à un autre objet.

Valeur de retour

Elle retourne un nombre qui représentebuf avant otherBuffer,ou après la même chose.

Exemples

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

Mise en œuvre du code ci-dessus, la sortie est:

ABC在ABCD之前

tampon Copy

grammaire

Syntaxe noeud de copie de mémoire tampon est la suivante:

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

Paramètres

Les paramètres sont décrits ci-dessous:

• objets tampon que vous souhaitez copier- targetBuffer.

• targetStart - numérique, en option, par défaut: 0

• sourceStart - numérique, en option, par défaut: 0

• sourceEnd - numérique, en option, par défaut: buffer.Length

Valeur de retour

Aucune valeur de retour.

Exemples

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

Mise en œuvre du code ci-dessus, la sortie est:

buffer2 content: ABC

Buffer des cultures

la syntaxe des cultures tampon du noeud est la suivante:

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

Paramètres

Les paramètres sont décrits ci-dessous:

• commencer - les numéros, en option, par défaut: 0

• fin - numérique, en option, par défaut: buffer.Length

Valeur de retour

Renvoie un nouveau tampon, il est vieux et pointent vers le même morceau de mémoire tampon, mais commencer à partir de l'index à l'emplacement de l'extrémité coupée.

Exemples

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

Mise en œuvre du code ci-dessus, la sortie est:

buffer2 content: ru

longueur Buffer

grammaire

syntaxe de calcul de la longueur de la mémoire tampon du noeud est la suivante:

buf.length;

Valeur de retour

Sauvegardez la mémoire tampon occupée par la longueur de l'objet.

Exemples

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

Mise en œuvre du code ci-dessus, la sortie est:

buffer length: 14

Manuel Méthode de référence

Voici une liste Module Node.js Buffer couramment méthode utilisée (Notez que certaines méthodes dans l'ancienne version est pas):

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