• Node.js Video Tutorials

Node.js - Buffer.writeUInt8() Method



The NodeJS Buffer.writeUInt8() method helps in writing an unsigned 8-bit integer of value at a given offset to the buffer.It returns undefined if the value is not a 8-bit unsigned integer.

Syntax

Following is the syntax of the Node.JS Buffer.writeUInt8() Method −

buf.writeUInt8(value[, offset])

Parameters

This method accepts two parameters. The same is explained below.

  • value − (required)An unsigned 8-bit number to be written to the buffer.

  • offset − The offset that indicates the position to start writing. The offset is greater than or equal to 0 and also less than or equal to buffer.length-1. The default value is 0.

Return value

The method buffer.writeUInt8() writes the given value and returns offset plus the number of bytes written.

Example

To create a buffer, we are going to make use of NodeJS Buffer.alloc() method −

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

Output

On execution the value starting from 0th position will be written to the buffer created. The buffer length created for the above is 10. So we can only use the offset with values from 0 to 9. If any value >9 it will give an error ERR_OUT_OF_RANGE.

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

Example

In this example will use buffer length as 5 and offset greater than buffer.length −4 .

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

Output

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 writeU_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

Example

In this example will create a buffer and write from an offset that is within in range.

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

Output

The offset has to be between 0 to 9.

<Buffer 00 00 00 00 0c 00 00 00 00 00>
nodejs_buffer_module.htm
Advertisements