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

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

Версия	Изменения
v12.19.0	Эта функция также доступна как `buf.writeBigUint64BE()`.
v12.0.0, v10.20.0	Добавлено в: v12.0.0, v10.20.0

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

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

const buf = Buffer.allocUnsafe(8);

buf.writeBigUInt64BE(0xdecafafecacefaden, 0);

console.log(buf);
// Prints: <Buffer de ca fa fe ca ce fa de>

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

Синтаксис:

Buffer.writeBigUInt64BE( value, offset )

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

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

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

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

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

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

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

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

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

node index.js

Выход:

<Buffer 00 01 03 04 05 06 07 08>

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

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

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

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

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