Permalink
Cannot retrieve contributors at this time
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
38 lines (36 sloc)
987 Bytes
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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 |