pad-left

Left pad a string with zeros or a specified string. Fastest implementation.

You might also be interested in word-wrap.

Install

Install with npm:

$ npm install pad-left --save

Usage

var pad = require('pad-left');
pad(  '4', 4, '0') // 0004
pad( '35', 4, '0') // 0035
pad('459', 4, '0') // 0459

Benchmarks

Benchmarks for node.js v6.5.0 versus left-pad.

# benchmark/fixtures/10-custom-char.js (37 bytes)
  pad-left x 14,660,838 ops/sec ±1.43% (84 runs sampled)
  left-pad x 9,189,792 ops/sec ±1.36% (81 runs sampled)

# benchmark/fixtures/10.js (32 bytes)
  pad-left x 13,357,570 ops/sec ±1.91% (84 runs sampled)
  left-pad x 20,375,277 ops/sec ±1.40% (82 runs sampled)

# benchmark/fixtures/100-custom-char.js (38 bytes)
  pad-left x 13,671,301 ops/sec ±1.58% (83 runs sampled)
  left-pad x 8,917,004 ops/sec ±1.84% (79 runs sampled)

# benchmark/fixtures/100.js (34 bytes)
  pad-left x 15,442,944 ops/sec ±1.68% (81 runs sampled)
  left-pad x 7,850,636 ops/sec ±1.47% (83 runs sampled)

# benchmark/fixtures/1000-custom-char.js (40 bytes)
  pad-left x 13,624,072 ops/sec ±1.25% (84 runs sampled)
  left-pad x 5,907,915 ops/sec ±1.13% (86 runs sampled)

# benchmark/fixtures/1000.js (35 bytes)
  pad-left x 14,241,788 ops/sec ±1.23% (81 runs sampled)
  left-pad x 5,418,351 ops/sec ±1.52% (80 runs sampled)

Related projects

You might also be interested in these projects:

align-text: Align the text in a string. | homepage
center-align: Center-align the text in a string. | homepage
justified: Wrap words to a specified length and justified the text. | homepage
pad-right: Right pad a string with zeros or a specified string. Fastest implementation. | homepage
repeat-string: Repeat the given string n times. Fastest implementation for repeating a string. | homepage
right-align-keys: Right align the keys of an object. | homepage
right-align-values: Right align the values of a given property for each object in an array. Useful… more | homepage
right-align: Right-align the text in a string. | homepage
right-pad-keys: Right pad the keys of an object. | homepage
right-pad-values: Right pad the values of a given property for each object in an array. Useful… more | homepage
word-wrap: Wrap words to a specified length. | homepage

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Building docs

Generate readme and API documentation with verb:

$ npm install verb && npm run docs

Or, if verb is installed globally:

$ verb

Running tests

Install dev dependencies:

$ npm install -d && npm test

Author

Jon Schlinkert

License

This file was generated by verb, v0.9.0, on May 07, 2016.

jonschlinkert / pad-left

readme