Tampon Node.js

Le langage JavaScript lui-même n'a que des types de données chaîne, pas des types de données binaires.

Mais lors du traitement de flux comme TCP ou de flux de fichiers, des données binaires doivent être utilisées. Par conséquent, dans Node.js, une classe Buffer est définie, qui est utilisée pour créer une zone tampon spécifiquement pour stocker les données binaires.

Dans Node.js, la classe Buffer est une bibliothèque principale livrée avec le noyau Node. La bibliothèque Buffer apporte une méthode de stockage de données brutes à Node.js, permettant à Node.js de traiter des données binaires. Chaque fois que vous avez besoin de traiter des données déplacées lors d'opérations d'E/S dans Node.js, il est possible d'utiliser la bibliothèque Buffer. . Les données brutes sont stockées dans des instances de la classe Buffer. Un Buffer est similaire à un tableau d'entiers, mais il correspond à un morceau de mémoire brute en dehors de la mémoire tas V8.

Création de la classe Buffer

La classe Node Buffer peut être créée de différentes manières.

Méthode 1

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

var buf = new Buffer(10);

Méthode 2

Créer une instance Buffer à partir du tableau donné :

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

Méthode 3

Créer une instance Buffer via une chaîne :

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

utf-8 est l'encodage par défaut, et il prend également en charge les encodages suivants : "ascii", " utf8", "utf16le", "ucs2", "base64" et "hex".

Write buffer

Syntaxe

La syntaxe d'écriture du Node buffer est la suivante :

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

Paramètres

Les paramètres sont décrits comme suit :

• string - la chaîne à écrire dans le tampon.

• offset - La valeur d'index à laquelle le tampon commence à être écrit, la valeur par défaut est 0.

• length - Nombre d'octets écrits, la valeur par défaut est buffer.length

• encoding - l'encodage à utiliser. La valeur par défaut est 'utf8'.

Valeur de retour

Renvoie la taille réelle écrite. Si l'espace tampon est insuffisant, seule une partie de la chaîne sera écrite.

Instance

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

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

exécute le code ci-dessus et le résultat de sortie est :

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

Lire les données du tampon

Syntaxe

La syntaxe de lecture des données du tampon Node est la suivante :

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

Paramètres

Les paramètres sont décrits comme suit :

• encoding - L'encodage utilisé. La valeur par défaut est 'utf8'.

• start - Spécifie la position de l'index pour commencer la lecture, la valeur par défaut est 0.

• end - Position de fin, par défaut à la fin du tampon.

Valeur de retour

Décode les données du tampon et renvoie une chaîne en utilisant l'encodage spécifié.

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

exécute le code ci-dessus, le résultat de sortie est :

$ node main.js
abcdefghijklmnopqrstuvwxyz
abcde
abcde
abcde

Convertir le tampon en objet JSON

Syntaxe

Le format de syntaxe de fonction pour convertir Node Buffer en objet JSON est le suivant :

buf.toJSON()

Valeur de retour

Renvoie l'objet JSON.

Instance

var buf = new Buffer('www.php.cn');
var json = buf.toJSON(buf);

console.log(json);

exécute le code ci-dessus et le résultat de sortie est :

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

Fusion de tampon

Syntaxe

Node buffer La syntaxe de fusion de zones est la suivante :

Buffer.concat(list[, totalLength])

Paramètres

Les paramètres sont décrits comme suit :

• list - Liste de tableaux d'objets Buffer à fusionner.

• totalLength - Spécifie la longueur totale des objets Buffer fusionnés.

Valeur de retour

Renvoie un nouvel objet Buffer qui combine plusieurs membres.

Instance

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

exécute le code ci-dessus et le résultat de sortie est :

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

Comparaison de tampon

Syntaxe

Node Buffer La syntaxe de la fonction de comparaison est la suivante. Cette méthode a été introduite dans Node.js v0.12.2 :

buf.compare(otherBuffer);

Paramètres

Les paramètres sont décrits comme suit :

• otherBuffer - Un autre objet Buffer comparé à l'objet buf.

Valeur de retour

Renvoie un nombre indiquant que buf est avant, après ou identique à otherBuffer.

Instance

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

exécute le code ci-dessus et le résultat de sortie est :

ABC在ABCD之前

Tampon de copie

Syntaxe

Node buffer La syntaxe de copie de zone est la suivante :

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

Parameters

La description du paramètre est la suivante :

• targetBuffer - l'objet Buffer à copier.

• targetStart - numéro, facultatif, par défaut : 0

• sourceStart - numéro, facultatif , par défaut : 0

• sourceEnd - Nombre, facultatif, par défaut : buffer.length

Valeur de retour

Aucune valeur de retour.

Instance

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

exécute le code ci-dessus et le résultat de sortie est :

buffer2 content: ABC

Buffer clipping

La syntaxe de découpage du tampon de nœud est la suivante :

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

Paramètres

Les paramètres sont décrits comme suit :

• start - nombre, facultatif, par défaut : 0

• end - Nombre, facultatif, par défaut : buffer.length

Valeur de retour

Renvoyer un new Buffer, qui pointe vers la même mémoire que l'ancien tampon, mais est coupé du début à la fin de l'index.

Instance

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

exécute le code ci-dessus et le résultat de sortie est :

buffer2 content: ru

Longueur du tampon

Syntaxe

Node buffer La syntaxe de calcul de la longueur de la zone est la suivante :

buf.length;

Valeur de retour

Renvoie la longueur mémoire occupée par l'objet Buffer.

Instance

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

Exécutez le code ci-dessus, le résultat de sortie est :

buffer length: 14

Manuel de référence de la méthode

Le module Node.js Buffer est répertoriées ci-dessous Méthodes couramment utilisées (notez que certaines méthodes ne sont pas disponibles dans les anciennes versions) :

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