Node.js Buffer (буфер)

JavaScript язык сам по себе только типы строки данных, без двоичный тип данных.

Но при работе с потоками, как поток TCP или файл, вы должны использовать двоичные данные. Таким образом, в Node.js, определение класса буфера, который используется для создания какого-либо специального буфера для хранения двоичных данных.

В Node.js, класс буфера выделяется вместе с основной библиотеки узла ядра. библиотека Буфер Node.js приносит способ хранения данных позволяет сырой Node.js обрабатывать двоичные данные, всякий раз, когда вам нужно обрабатывать операции ввода / вывода для перемещения данных Node.js, когда можно использовать библиотеку буфера , Исходные данные хранятся в экземпляре класса Buffer. Буфер похож на массив целых чисел, но она соответствует сырым памяти вне кучи V8.

Создание класса Buffer

Класс Node буфера могут быть созданы несколькими способами.

Способ 1

Создание экземпляра длину буфера 10 байт:

var buf = new Buffer(10);

Способ 2

Благодаря данной создании массива Buffer Пример:

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

Способ 3

Создание экземпляра буфера с помощью строки:

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

UTF-8 кодировка по умолчанию, кроме того, он также поддерживает следующие кодировки: "ASCII", "utf8", "utf16le", "ucs2", "base64" и "шестигранной".

Запись буфера

грамматика

Синтаксис узла буфер записи выглядит следующим образом:

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

параметры

Параметры описаны ниже:

• строка - строка буфер записывается.

• Смещение - буфер индексов , чтобы начать запись, по умолчанию равно 0.

• длина - количество записанных байтов, по умолчанию buffer.length

• кодирование - кодирование используется.По умолчанию 'utf8'.

Возвращаемое значение

Возвращает размер фактического письма. Если буферное пространство, единственная часть строки записывается.

примеров

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

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

Реализация указанного выше кода, выход:

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

Читает данные из буфера

грамматика

Узел чтения синтаксис буфер данных выглядит следующим образом:

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

параметры

Параметры описаны ниже:

• кодирование - кодирование используется.По умолчанию 'utf8'.

• начать - начать чтение указанной позиции индекса, по умолчанию равно 0.

• конец - конечное положение, по умолчанию это конец буфера.

Возвращаемое значение

Расшифровка данных буфера и возвращает строку, используя указанную кодировку.

примеров

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

Реализация указанного выше кода, выход:

$ node main.js
abcdefghijklmnopqrstuvwxyz
abcde
abcde
abcde

Буфер будет преобразован в объект JSON

грамматика

Узел буфера в JSON синтаксис функции объекта выглядит следующим образом:

buf.toJSON()

Возвращаемое значение

Возвращает объект JSON.

примеров

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

console.log(json);

Реализация указанного выше кода, выход:

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

Буфер Объединить

грамматика

буфера узла в сочетании синтаксис выглядит следующим образом:

Buffer.concat(list[, totalLength])

параметры

Параметры описаны ниже:

• список - массив объектов для буфера объединенного списка.

• totalLength - по истечении заданного общей суммарной длины объекта буфера.

Возвращаемое значение

Возвращение нескольких членов объединенного нового объекта буфера.

примеров

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

Реализация указанного выше кода, выход:

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

буфер сравнения

грамматика

Узел буфера сравнить синтаксис функции выглядит следующим образом, метод введен в Node.js v0.12.2 версии:

buf.compare(otherBuffer);

параметры

Параметры описаны ниже:

• otherBuffer - по сравнению с Bufобъектов буфера в другой объект.

Возвращаемое значение

Она возвращает число , которое представляетЬиЕ ранее otherBuffer,или после того же.

примеров

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

Реализация указанного выше кода, выход:

ABC在ABCD之前

буфер копирования

грамматика

Синтаксис узла буфера копирования выглядит следующим образом:

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

параметры

Параметры описаны ниже:

• targetBuffer - Buffer объекты , которые вы хотите скопировать.

• targetStart - цифровой, необязательный, по умолчанию: 0

• sourceStart - цифровой, необязательный, по умолчанию: 0

• sourceEnd - цифровой, необязательный, по умолчанию: buffer.length

Возвращаемое значение

Нет возвращаемого значения.

примеров

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

Реализация указанного выше кода, выход:

buffer2 content: ABC

Буфер Crop

Синтаксис Node буфера культур выглядит следующим образом:

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

параметры

Параметры описаны ниже:

• старт - номера, необязательный, по умолчанию: 0

• конец - цифровой, необязательный, по умолчанию: buffer.length

Возвращаемое значение

Возвращает новый буфер, он старый и указывают на тот же кусок буфера памяти, но исходить из индекса к местоположению конца разреза.

примеров

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

Реализация указанного выше кода, выход:

buffer2 content: ru

длина буфера

грамматика

буфер узла синтаксис вычисления длины выглядит следующим образом:

buf.length;

Возвращаемое значение

Back Buffer память, занятую длины объекта.

примеров

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

Реализация указанного выше кода, выход:

buffer length: 14

Метод Справочное руководство

Ниже приведен список Node.js буфера модуль обычно используемый метод (Обратите внимание, что некоторые методы в старой версии нет):

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