Skip to content
A ponyfill for Buffer.fill
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
LICENSE
index.js
package.json
readme.md
test.js

readme.md

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

You can’t perform that action at this time.