| var createPadding = require('./_createPadding'), | |
| stringSize = require('./_stringSize'), | |
| toInteger = require('./toInteger'), | |
| toString = require('./toString'); | |
| /** | |
| * Pads `string` on the left side if it's shorter than `length`. Padding | |
| * characters are truncated if they exceed `length`. | |
| * | |
| * @static | |
| * @memberOf _ | |
| * @since 4.0.0 | |
| * @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 | |
| * | |
| * _.padStart('abc', 6); | |
| * // => ' abc' | |
| * | |
| * _.padStart('abc', 6, '_-'); | |
| * // => '_-_abc' | |
| * | |
| * _.padStart('abc', 3); | |
| * // => 'abc' | |
| */ | |
| function padStart(string, length, chars) { | |
| string = toString(string); | |
| length = toInteger(length); | |
| var strLength = length ? stringSize(string) : 0; | |
| return (length && strLength < length) | |
| ? (createPadding(length - strLength, chars) + string) | |
| : string; | |
| } | |
| module.exports = padStart; |