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.