Node.js Buffer buf.fill(value[, offset[, end]][, encoding])用法及代碼示例

buf.fill(value[, offset[, end]][, encoding])

參數

• value <string> | <Buffer> | <Uint8Array> | <integer> 要填充的值 buf 。
• offset <integer> 開始填充之前要跳過的字節數 buf 。 默認： 0 。
• end <integer> 在哪裏停止填充 buf(不包括在內)。 默認： buf.length 。
• encoding <string> 如果 value 是字符串，則 value 的編碼。 默認： 'utf8' 。
• 返回： <Buffer> 對 buf 的引用。

用指定的 value 填充 buf 。如果沒有給出offset和end，則將填充整個buf：

import { Buffer } from 'node:buffer';

// Fill a `Buffer` with the ASCII character 'h'.

const b = Buffer.allocUnsafe(50).fill('h');

console.log(b.toString());
// Prints: hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhconst { Buffer } = require('node:buffer');

// Fill a `Buffer` with the ASCII character 'h'.

const b = Buffer.allocUnsafe(50).fill('h');

console.log(b.toString());
// Prints: hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh

如果 value 不是字符串、Buffer 或整數，則 value 被強製轉換為 uint32 值。如果結果整數大於 255(十進製)，則 buf 將用 value & 255 填充。

如果 fill() 操作的最終寫入落在 multi-byte 字符上，則僅寫入適合 buf 的該字符的字節：

import { Buffer } from 'node:buffer';

// Fill a `Buffer` with character that takes up two bytes in UTF-8.

console.log(Buffer.allocUnsafe(5).fill('\u0222'));
// Prints: <Buffer c8 a2 c8 a2 c8>const { Buffer } = require('node:buffer');

// Fill a `Buffer` with character that takes up two bytes in UTF-8.

console.log(Buffer.allocUnsafe(5).fill('\u0222'));
// Prints: <Buffer c8 a2 c8 a2 c8>

如果value包含無效字符，則被截斷；如果沒有有效的填充數據，則拋出異常：

import { Buffer } from 'node:buffer';

const buf = Buffer.allocUnsafe(5);

console.log(buf.fill('a'));
// Prints: <Buffer 61 61 61 61 61>
console.log(buf.fill('aazz', 'hex'));
// Prints: <Buffer aa aa aa aa aa>
console.log(buf.fill('zz', 'hex'));
// Throws an exception.const { Buffer } = require('node:buffer');

const buf = Buffer.allocUnsafe(5);

console.log(buf.fill('a'));
// Prints: <Buffer 61 61 61 61 61>
console.log(buf.fill('aazz', 'hex'));
// Prints: <Buffer aa aa aa aa aa>
console.log(buf.fill('zz', 'hex'));
// Throws an exception.