Buffer Fill

A ponyfill for Buffer.fill.

Works as Node.js: v6.4.0
Works on Node.js: v0.10.0

Installation

npm install --save buffer-fill

Usage

const fill = require('buffer-fill')
const buf = Buffer.allocUnsafe(5)
 
console.log(buf.fill(8))
//=> <Buffer 08 08 08 08 08>
 
console.log(buf.fill(9, 2, 4))
//=> <Buffer 08 08 09 09 08>
 
console.log(buf.fill('linus', 'latin1'))
//=> <Buffer 6c 69 6e 75 73>
 
console.log(buf.fill('\u0222'))
//=> <Buffer c8 a2 c8 a2 c8>

API

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

• value <String> | <Buffer> | <Integer> The value to fill buf with
• offset <Integer> Where to start filling buf. Default: 0
• end <Integer> Where to stop filling buf (not inclusive). Default: buf.length
• encoding <String> If value is a string, this is its encoding. Default: 'utf8'
• Return: <Buffer> A reference to buf

Fills buf with the specified value. If the offset and end are not given, the entire buf will be filled. This is meant to be a small simplification to allow the creation and filling of a Buffer to be done on a single line.

If the final write of a fill() operation falls on a multi-byte character, then only the first bytes of that character that fit into buf are written.

See also

• buffer-alloc-unsafe A ponyfill for Buffer.allocUnsafe
• buffer-alloc A ponyfill for Buffer.alloc
• buffer-from A ponyfill for Buffer.from