Node.js - Buffer.writeInt8() 方法

Buffer.writeInt8() 方法用於將給定值的有符號 8 位整數寫入緩衝區的指定偏移量。如果值不是 8 位有符號整數，則返回 undefined。

語法

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

buf.writeInt8(value[, offset])

引數

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

• value − (必填) 要寫入緩衝區的 8 位有符號整數。

• offset − 指示寫入起始位置的偏移量。偏移量大於或等於 0，小於或等於 buffer.length-1。預設值為 0。

返回值

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

示例

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

const buffer = Buffer.alloc(10);
buffer.writeInt8(8)
console.log(buffer);

輸出

執行後，從第 0 個位置開始的值將寫入建立的緩衝區。上面建立的緩衝區長度為 10。因此，我們只能使用 0 到 9 的偏移量值。任何大於 9 的值都會引發 ERR_OUT_OF_RANGE 錯誤。

<Buffer 08 00 00 00 00 00 00 00 00 00>

示例

在這個例子中，我們將使用緩衝區長度為 5，偏移量大於 buffer.length -4。

const buffer = Buffer.alloc(5);
buffer.writeInt8(8, 5);
console.log(buffer);

輸出

internal/buffer.js:58
   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 <= 4. Received 5
   at boundsError (internal/buffer.js:58:9)
   at write_Int8 (internal/buffer.js:575:5)
   at Buffer.writeUInt8 (internal/buffer.js:582:10)
   at Object.<anonymous> (C:\nodejsProject\src\testbuffer.js:2:8)
   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

示例

在這個例子中，我們將建立一個緩衝區，並從一個在範圍內的偏移量開始寫入。

const buffer = Buffer.alloc(10);
buffer.writeInt8(12, 4);
console.log(buffer)

輸出

偏移量必須在 0 到 9 之間。執行上述程式碼的輸出如下所示：

<Buffer 00 00 00 00 0c 00 00 00 00 00>