import createPadding from './.internal/createPadding.js'; import stringSize from './.internal/stringSize.js'; /** * 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`. * * @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', 2) * // => 'abc' */ function pad(string, length, chars) { const strLength = length ? stringSize(string) : 0; if (!length || strLength >= length) { return string || ''; } const mid = (length - strLength) / 2; return createPadding(Math.floor(mid), chars) + string + createPadding(Math.ceil(mid), chars); } export default pad;