Node.js - Buffer.from() 方法

---

---

NodeJS 的 Buffer.from() 方法将创建一个 ArrayBuffer 的副本，而不会复制底层内存。当将 TypedArray 实例的 .buffer 属性传递给 Buffer.from() 时，创建的缓冲区将与 TypedArray 共享相同的内存。

TypedArray 只不过是一个具有数组视图的对象。TypedArray 的示例包括：new Int8Array()，new Uint16Array()。

语法

以下是 Node.JS Buffer.from(arrayBuffer[, byteOffset[, length]]) 方法 的语法：

Buffer.from(arrayBuffer[, byteOffset[, length]])
Buffer.from(buffer)
Buffer.from(str[, encoding])

参数

此方法接受三个参数。解释如下。

• arrayBuffer − (必需) 一个 ArrayBuffer，SharedArrayBuffer，例如 TypedArray 的 .buffer 属性。

• byteOffset − (可选) 一个偏移值。默认为 0。

• length − (可选) 要公开的字节数。默认值为 arrayBuffer.length - byteOffset。

• buffer − (必需) 一个缓冲区对象。

• str − (必需) 一个字符串值。

• encoding −(可选) 要使用的编码。默认为 utf-8。

返回值

Buffer.from(arrayBuffer[, byteOffset[, length]]) 方法返回一个新的缓冲区，其 .buffer 属性来自 TypedArray。

示例

在这个示例中，我们将使用 NodeJS Int8Array() 并从中创建一个缓冲区。

const arr = new Int8Array(5);
arr[0] = 1;
arr[1] = 2;
arr[2] = 3;
const buf = Buffer.from(arr.buffer);
console.log(buf);

输出

<Buffer 01 02 03 00 00>

示例

此示例将使用 Int8Array() 和 byteOffset 参数，并从中创建一个缓冲区。

const arr = new Int8Array(5);
arr[0] = 1;
arr[1] = 2;
arr[2] = 3;
const buf = Buffer.from(arr.buffer, 1);
console.log(buf);

输出

<Buffer 02 03 00 00>

示例

此示例将使用 Int8Array()、byteOffset 和 length 参数，并从中创建一个缓冲区。

const arr = new Int8Array(5);
arr[0] = 1;
arr[1] = 2;
arr[2] = 3;
const buf = Buffer.from(arr.buffer, 1, 3);
console.log(buf);

输出

<Buffer 02 03 00>

示例

此示例将使用 buffer.from(buffer) 方法创建一个新的缓冲区。

const buffer1 = Buffer.from('Hello World');
const buffer2 = Buffer.from(buffer1);
console.log(buffer1.toString());
console.log(buffer2.toString());

输出

Hello World
Hello World

示例

如果给定的输入不是缓冲区，则 Buffer.from() 方法将引发类型错误。

const buffer1 = 1;
const buffer2 = Buffer.from(buffer1);
console.log(buffer2);

输出

TypeError [ERR_INVALID_ARG_TYPE]: The "value" argument must not be of type number. Received type number
   at Function.from (buffer.js:208:11)
   at Object.<anonymous> (C:\nodejsProject\src\testbuffer.js:2:24)
   at Module._compile (internal/modules/cjs/loader.js:816:30)
   at Object.Module._extensions..js (internal/modules/cjs/loader.js:827:10)
   at Module.load (internal/modules/cjs/loader.js:685:32)
   at Function.Module._load (internal/modules/cjs/loader.js:620:12)
   at Function.Module.runMain (internal/modules/cjs/loader.js:877:12)
   at internal/main/run_main_module.js:21:11

示例

此示例将使用 NodeJS buffer.from() 方法创建一个新的缓冲区。

const obj = new String('Welcome to Tutorialspoint!');
console.log(obj.valueOf());
const newbuffer = Buffer.from(obj);
console.log(newbuffer);

输出

Welcome to Tutorialspoint!
<Buffer 57 65 6c 63 6f 6d 65 20 74 6f 20 54 75 74 6f 72 69 61 6c 73 70 6f 69 6e 74 21>

示例

此示例将使用 buffer.from() 方法创建一个新的缓冲区。

const object1 = {
   [Symbol.toPrimitive]() {
      return 'testing buffer';
   }
};  
const newBuffer = Buffer.from(object1, 'utf8');
console.log(newBuffer);

输出

<Buffer 74 65 73 74 69 6e 67 20 62 75 66 66 65 72>

示例

此示例将使用 buffer.from() 方法，使用对象、编码和长度创建一个新的缓冲区。

const object1 = {
   [Symbol.toPrimitive]() {
      return 'testing buffer';
   }
};  
const newBuffer = Buffer.from(object1, 'utf-8', 10);
console.log(newBuffer);

输出

<Buffer 74 65 73 74 69 6e 67 20 62 75 66 66 65 72>