Método Node.js Buffer.writeInt16BE()

El método Buffer.writeInt16BE() es una interfaz de programación de aplicaciones incorporada de clase Buffer dentro del módulo Buffer que se usa para escribir un valor entero en el búfer en el desplazamiento especificado con el formato big-endian. El valor entero debe ser un entero válido de 16 bits con signo. Se genera un error si el valor está fuera del rango de enteros de 16 bits con signo. El valor entero se interpreta y escribe como un entero con signo en complemento a dos.

Sintaxis:

Buffer.writeInt16BE( value, offset )

Parámetros: Este método acepta dos parámetros como se mencionó anteriormente y se describe a continuación:

• valor: es un entero de 16 bits con signo que debe escribirse en el búfer.
• offset: es un valor entero, es decir, el número de bytes que se saltan antes de comenzar a escribir en el búfer. El valor de offset se encuentra entre 0 y buf.length-2 . Es un parámetro opcional y su valor por defecto es 0.

Valor devuelto: Devuelve un valor entero que es la suma del desplazamiento más el número de bytes escritos.

Los siguientes ejemplos ilustran el uso del método buf.writeInt16BE() en Node.js:

Ejemplo 1:

// Node.js program to demonstrate the   
// Buffer.writeInt16BE() Method 
    
// Allocate a buffer
const buf = Buffer.allocUnsafe(2);
  
// Writing the value to the buffer
buf.writeInt16BE(0x7bca);
  
// Display the buffer value
console.log(buf);

Producción:

<Buffer 7b ca>

Ejemplo 2:

// Node.js program to demonstrate the   
// Buffer.writeInt16BE() Method 
    
// Allocate a buffer
const buf = Buffer.allocUnsafe(4);
  
// Writing the value to the buffer
// from 0 offset
buf.writeInt16BE(0x7bca, 0);
  
// Writing the value to the buffer
// from 2 offset
buf.writeInt16BE(0x7fff, 2);
  
// Display the result
console.log(buf); 

Producción:

<Buffer 7b ca 7f ff>

Ejemplo 3:

// Node.js program to demonstrate the   
// Buffer.writeInt16BE() Method 
    
// Allocate a buffer
const buf = Buffer.allocUnsafe(4);
  
// Writing the value to the buffer
// from 0 offset
buf.writeInt16BE(0x7bca, 0);
  
// Writing the value to the buffer
// from 2 offset
buf.writeInt16BE(0x7fff, 3);
  
// Display the result
console.log(buf); 

Producción:

internal/buffer.js:72
  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 <= 2. Received 3
. . .

Referencia: https://nodejs.org/api/buffer.html#buffer_buf_writeint16be_value_offset