28 lines
654 B
JavaScript
28 lines
654 B
JavaScript
|
var createPadDir = require('../internal/createPadDir');
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Pads `string` on the left side if it's shorter than `length`. Padding
|
||
|
|
* characters are truncated if they exceed `length`.
|
||
|
|
*
|
||
|
|
* @static
|
||
|
|
* @memberOf _
|
||
|
|
* @category String
|
||
|
|
* @param {string} [string=''] The string to pad.
|
||
|
|
* @param {number} [length=0] The padding length.
|
||
|
|
* @param {string} [chars=' '] The string used as padding.
|
||
|
|
* @returns {string} Returns the padded string.
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* _.padLeft('abc', 6);
|
||
|
|
* // => ' abc'
|
||
|
|
*
|
||
|
|
* _.padLeft('abc', 6, '_-');
|
||
|
|
* // => '_-_abc'
|
||
|
|
*
|
||
|
|
* _.padLeft('abc', 3);
|
||
|
|
* // => 'abc'
|
||
|
|
*/
|
||
|
|
var padLeft = createPadDir();
|
||
|
|
|
||
|
|
module.exports = padLeft;
|