Método Node.js Buffer.writeInt32BE()

El método Buffer.writeInt32BE() 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 32 bits con signo . Se genera un error si el valor está fuera del rango de un entero de 32 bits con signo. El valor entero se interpreta y se escribe como un entero con signo en complemento a dos.

Sintaxis:

Buffer.writeInt32BE( value, offset )

Parámetros: este método acepta dos parámetros, como se mencionó anteriormente y se describe a continuación:
valor: este parámetro contiene un número entero de 32 bits con signo que debe escribirse en el búfer.
offset: este parámetro contiene 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 – 4 . Es un parámetro opcional y su valor por defecto es 0.

Valor devuelto: este método devuelve un valor entero, es decir, la suma del desplazamiento más el número de bytes escritos.

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

Ejemplo 1:

// Node.js program to demonstrate the  
// Buffer.writeInt32BE() Method
  
// Allocating buffer space of 4 bytes
const buf = Buffer.allocUnsafe(4);
  
// Writing the value to the buffer
buf.writeInt32BE(0x7bcaf892);
  
// Display the buffer to stdout
console.log(buf);

Producción:

<Buffer 7b ca f8 92>

Ejemplo 2:

// Node.js program to demonstrate the  
// Buffer.writeInt32BE() Method
  
// Allocating buffer space of 8 bytes
const buf = Buffer.allocUnsafe(8);
   
// Writing the value to the buffer from 0 offset
buf.writeInt32BE(0x7bcaf983, 0);
  
// Writing the value to the buffer from 4 offset
buf.writeInt32BE(0x7fffffff, 4);
   
// Display the buffer to stdout
console.log(buf);

Producción:

<Buffer 7b ca f9 83 7f ff ff ff>

Ejemplo 3: este ejemplo mostrará un mensaje de error porque la compensación es mayor que el límite, es decir, el valor de compensación no se encuentra entre 0 y buf.length – 4.

// Node.js program to demonstrate the  
// Buffer.writeInt32BE() Method
  
// Allocating buffer space of 8 bytes
const buf = Buffer.allocUnsafe(8);
   
// Writing the value to the buffer from 0 offset
buf.writeInt32BE(0x7bcaf983, 0);
  
// Writing the value to the buffer from 4 offset
buf.writeInt32BE(0x7fffffff, 5);
   
// Display the buffer to stdout
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 <= 4. Received 5
. . .

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