Node.js - Buffer.writeInt16LE() 方法

---

---

Buffer.writeInt16LE() 方法用於以小端序的形式將一個帶符號的 16 位整數寫入緩衝區中的給定偏移量。寫入緩衝區的整數表示為二進位制補碼帶符號值。

16 位帶符號整數的取值範圍是 -32768 到 32767。

**二進位制補碼**是二進位制數的一種數學運算。要獲得任何給定二進位制數的二進位制補碼，步驟如下：

二進位制數: 101011

• **步驟 1** - 首先找到二進位制數 101011 的反碼：要獲得反碼，你需要將 1 變成 0，將 0 變成 1。所以上面二進位制數的反碼是：010100。

• **步驟 2** - 現在，對於步驟 1 中的反碼，加上 1。

I.e. 010100 + 1 = 010101. So 010101 is the two's complement of binary number 101011.

語法

以下是 **Node.JS Buffer.writeInt16LE() 方法** 的語法：

buf.writeInt16LE(value[, offset])

引數

此方法接受兩個引數。解釋如下。

• **value** - （必需）要寫入緩衝區的帶符號 16 位整數。

• **offset** - 指示開始讀取位置的偏移量。偏移量大於或等於 0，小於或等於 buffer.length-2。預設值為 0。

返回值

方法 **buffer.writeInt16LE()** 寫入給定值並返回偏移量加上寫入的位元組數。

示例

要建立緩衝區，我們將使用 NodeJS Buffer.alloc() 方法：

const buffer = Buffer.alloc(10);
buffer.writeInt16LE(0x0910, 0);
console.log(buffer);

輸出

我們使用的偏移量是 0。執行時，從第 0 位開始的值將被寫入建立的緩衝區。上面建立的緩衝區長度為 10。因此，我們只能使用 0 到 8 的偏移量值。如果任何值 > 8，它將給出錯誤 **ERR_OUT_OF_RANGE**。

<Buffer 10 09 00 00 00 00 00 00 00 00>

示例

在這個例子中，我們將使用一個大於 buffer.length - 2 的偏移量。它應該丟擲如下所示的錯誤。

const buffer = Buffer.alloc(10);
buffer.writeInt16LE(0x0910, 9);
console.log(buffer);

輸出

internal/buffer.js:83
   throw new ERR_OUT_OF_RANGE(type || 'offset',
   ^
   
RangeError [ERR_OUT_OF_RANGE]: The value of "offset" is out of range. It must be >= 0 and <= 8. Received 9
   at boundsError (internal/buffer.js:83:9)
   at checkBounds (internal/buffer.js:52:5)
   at checkInt (internal/buffer.js:71:3)
   at writeU_Int16LE (internal/buffer.js:719:3)
   at Buffer.writeInt16LE (internal/buffer.js:862:10)
   at Object.<anonymous> (C:\nodejsProject\src\testbuffer.js:2:8)
   at Module._compile (internal/modules/cjs/loader.js:1063:30)
   at Object.Module._extensions..js (internal/modules/cjs/loader.js:1092:10)
   at Module.load (internal/modules/cjs/loader.js:928:32)
   at Function.Module._load (internal/modules/cjs/loader.js:769:14) {
      code: 'ERR_OUT_OF_RANGE'
   }

示例

要建立緩衝區，我們將使用 Buffer.allocUnsafe() 方法：

const buffer = Buffer.allocUnsafe(10);
buffer.writeInt16LE(0x0910);
console.log(buffer);

輸出

未使用偏移量，預設情況下將取為 0。因此，上面的輸出如下所示：

<Buffer 00 00 11 45 01 00 00 00 00 00>