| var createPadding = require('./_createPadding'), |
| stringSize = require('./_stringSize'), |
| toInteger = require('./toInteger'), |
| toString = require('./toString'); |
| |
| /* Built-in method references for those with the same name as other `lodash` methods. */ |
| var nativeCeil = Math.ceil, |
| nativeFloor = Math.floor; |
| |
| /** |
| * Pads `string` on the left and right sides if it's shorter than `length`. |
| * Padding characters are truncated if they can't be evenly divided by `length`. |
| * |
| * @static |
| * @memberOf _ |
| * @since 3.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 |
| * |
| * _.pad('abc', 8); |
| * // => ' abc ' |
| * |
| * _.pad('abc', 8, '_-'); |
| * // => '_-abc_-_' |
| * |
| * _.pad('abc', 3); |
| * // => 'abc' |
| */ |
| function pad(string, length, chars) { |
| string = toString(string); |
| length = toInteger(length); |
| |
| var strLength = length ? stringSize(string) : 0; |
| if (!length || strLength >= length) { |
| return string; |
| } |
| var mid = (length - strLength) / 2; |
| return ( |
| createPadding(nativeFloor(mid), chars) + |
| string + |
| createPadding(nativeCeil(mid), chars) |
| ); |
| } |
| |
| module.exports = pad; |