Node.js Buffer | Метод Buffer.writeBigInt64LE()

`buf.writeBigInt64LE(value[, offset])`

Добавлено в: v12.0.0, v10.20.0

value <bigint> Номер, на который нужно записать buf.
offset <integer> Количество байтов, которые необходимо пропустить перед началом записи.
Должно удовлетворять: 0 <= offset <= buf.length - 8.
По умолчанию: 0.
Возвращает: <integer> offset плюс количество записанных байтов.

Записывает valuebuf на указанный offset как little-endian.

value интерпретируется и записывается как целое число со знаком дополнения двойки.

const buf = Buffer.allocUnsafe(8);

buf.writeBigInt64LE(0x0102030405060708n, 0);

console.log(buf);
// Prints: <Buffer 08 07 06 05 04 03 02 01>

Метод Buffer.writeBigInt64LE() представляет собой встроенный интерфейс прикладного программирования класса Buffer в модуле Buffer, который используется для записи небольшого конечного 64-битного большого целого значения в выделенный буфер с указанным смещением.

Синтаксис:

Buffer.writeBigInt64LE( value, offset )

Параметры: Этот метод принимает два параметра, как указано выше и описано ниже:

value (ценность): Этот параметр указывает большое целочисленное значение, которое должно быть записано в буфер. Это должно быть допустимое 64 — битное значение малого конечного большого значения. Поведение не определено, когда значение чего-либо другого, чем это.
offset (смещение): Он указывает количество байтов, которые необходимо пропустить перед записью, или просто указывает индекс в буфере. Значение смещения лежит 0 <= offset <= Buffer.length – 8 его значение по умолчанию равно 0.

Return Value (Возвращаемое Значение): Этот метод возвращает целое значение, представляющее собой сумму смещения и количества записанных байтов.

Приведенные ниже примеры иллюстрируют использование метода Buffer.writeBigInt64LE() в Node.js:

Пример 1:
Имя файла: index.js

// Node.js program to demonstrate the
// buffer.writeBigInt64lE() method
const buf = Buffer.allocUnsafe(8);

// Writing big integer value into buffer
// by using writeBigInt64LE() method
buf.writeBigInt64LE(0x01030405060708n, 0);

// Display the buffer
console.log(buf);

Запустите index.js файл с помощью следующей команды:

node index.js

Выход:

<Buffer 08 07 06 05 04 03 01 00>

Пример 2:
Имя файла: index.js

// Node.js program to demonstrate the
// buffer.writeBigInt64lE() method
const buf = Buffer.allocUnsafe(8);

// Writing big integer value into buffer
// by using writeBigInt64LE() method
buf.writeBigInt64LE(0xaa03040506efffn, 0);

// Display the buffer
console.log(buf);

Запустите index.js файл с помощью следующей команды: