Penampan Node.js

Bahasa JavaScript itu sendiri hanya mempunyai jenis data rentetan, bukan jenis data binari.

Tetapi apabila memproses strim seperti TCP atau strim fail, data binari mesti digunakan. Oleh itu, dalam Node.js, kelas Penampan ditakrifkan, yang digunakan untuk mencipta kawasan penimbal khusus untuk menyimpan data binari.

Dalam Node.js, kelas Penampan ialah perpustakaan teras yang dihantar dengan teras Node. Pustaka Buffer membawa kaedah menyimpan data mentah ke Node.js, membenarkan Node.js memproses data binari Setiap kali anda perlu memproses data yang dialihkan semasa operasi I/O dalam Node.js, adalah mungkin untuk menggunakan pustaka Penampan. . Data mentah disimpan dalam keadaan kelas Penampan. Penampan adalah serupa dengan tatasusunan integer, tetapi ia sepadan dengan sekeping memori mentah di luar memori timbunan V8.

Mencipta kelas Penampan

Kelas Penampan Nod boleh dibuat dalam pelbagai cara.

Kaedah 1

Buat tika Buffer dengan panjang 10 bait:

var buf = new Buffer(10);

Kaedah 2

Buat tika Buffer daripada tatasusunan yang diberikan:

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

Kaedah 3

Buat tika Buffer melalui rentetan:

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

utf-8 ialah pengekodan lalai dan ia turut menyokong pengekodan berikut: "ascii", " utf8", "utf16le", "ucs2", "base64" dan "hex".

Tulis penimbal

Sintaks

Sintaks untuk menulis Penimbal Nod adalah seperti berikut:

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

Parameter

Parameter diterangkan seperti berikut:

• rentetan - rentetan untuk ditulis pada penimbal.

• mengimbangi - Nilai indeks di mana penimbal mula ditulis, lalai ialah 0.

• panjang - Bilangan bait yang ditulis, lalai ialah penimbal.length

• pengekodan - pengekodan untuk digunakan. Lalai kepada 'utf8' .

Nilai Pulangan

Mengembalikan saiz bertulis sebenar. Jika ruang penimbal tidak mencukupi, hanya sebahagian daripada rentetan akan ditulis.

Instance

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

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

melaksanakan kod di atas, dan hasil output ialah:

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

Baca data daripada penimbal

Sintaks

Sintaks untuk membaca data penimbal Nod adalah seperti berikut:

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

Parameter

Parameter diterangkan seperti berikut:

• pengekodan - Pengekodan yang digunakan. Lalai kepada 'utf8' .

• mula - Menentukan kedudukan indeks untuk mula membaca, lalai ialah 0.

• tamat - Kedudukan tamat, lalai pada penghujung penimbal.

Nilai pulangan

Nyahkod data penimbal dan kembalikan rentetan menggunakan pengekodan yang ditentukan.

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

melaksanakan kod di atas, hasil output ialah:

$ node main.js
abcdefghijklmnopqrstuvwxyz
abcde
abcde
abcde

Tukar Penampan kepada objek JSON

Sintaks

Format sintaks fungsi untuk menukar Penimbal Nod kepada objek JSON adalah seperti berikut:

buf.toJSON()

Nilai pulangan

Mengembalikan objek JSON.

Instance

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

console.log(json);

melaksanakan kod di atas, dan hasil output ialah:

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

Penimbal cantum

Sintaks

Penampan nod Sintaks penggabungan zon adalah seperti berikut:

Buffer.concat(list[, totalLength])

Parameter

Parameter diterangkan seperti berikut:

• senarai - Senarai tatasusunan objek Penampan untuk digabungkan.

• totalLength - Menentukan jumlah panjang objek Buffer yang digabungkan.

Nilai Pulangan

Mengembalikan objek Penampan baharu yang menggabungkan berbilang ahli.

Instance

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

melaksanakan kod di atas, dan hasil output ialah:

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

Perbandingan penimbal

Sintaks

Penampan Nod Sintaks fungsi untuk perbandingan adalah seperti berikut Kaedah ini diperkenalkan dalam Node.js v0.12.2:

buf.compare(otherBuffer);

Parameter

Parameter diterangkan seperti berikut:

• otherBuffer - Satu lagi objek Penampan berbanding dengan objek buf.

Nilai Pulangan

Mengembalikan nombor yang menunjukkan bahawa buf adalah sebelum, selepas, atau sama dengan 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 + "之后");
}

melaksanakan kod di atas, dan hasil output ialah:

ABC在ABCD之前

Copy buffer

Syntax

Penampan nod Sintaks salinan kawasan adalah seperti berikut:

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

Parameter

Penerangan parameter adalah seperti berikut:

• targetBuffer - objek Penampan untuk disalin .

• targetStart - nombor, pilihan, lalai: 0

• sourceStart - nombor, Pilihan , lalai: 0

• sourceEnd - Nombor, pilihan, lalai: buffer.length

Nilai pulangan

Tiada nilai pulangan.

Instance

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

melaksanakan kod di atas, dan hasil output ialah:

buffer2 content: ABC

Keratan penimbal

Sintaks keratan penimbal nod adalah seperti berikut :

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

Parameter

Parameter diterangkan seperti berikut:

• mula - nombor, pilihan, lalai: 0

• tamat - Nombor, pilihan, lalai: buffer.length

Nilai pulangan

Kembalikan a Penampan baru, yang menunjukkan memori yang sama seperti penimbal lama, tetapi dipotong dari mula indeks hingga akhir.

Instance

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

melaksanakan kod di atas, dan hasil output ialah:

buffer2 content: ru

Panjang penimbal

Sintaks

Penampan nod Sintaks pengiraan panjang kawasan adalah seperti berikut:

buf.length;

Nilai pulangan

Mengembalikan panjang memori yang diduduki oleh objek Penampan.

Instance

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

Laksanakan kod di atas, hasil output ialah:

buffer length: 14

Manual Rujukan Kaedah

Modul Penimbal Node.js ialah disenaraikan di bawah Kaedah yang biasa digunakan (perhatikan bahawa beberapa kaedah tidak tersedia dalam versi lama):

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