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>