pad-left
![Build Status](https://camo.githubusercontent.com/3c38e43c72ca1dc838c9cb755bada784700987912609205d2438cb1e6736f1d3/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f6a6f6e7363686c696e6b6572742f7061642d6c6566742e7376673f7374796c653d666c6174)
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
Copyright © 2016, Jon Schlinkert. Released under the MIT license.
This file was generated by verb, v0.9.0, on May 07, 2016.