mirror of
https://github.com/whoisclebs/lodash.git
synced 2026-01-31 15:27:50 +00:00
e51a424513
* Enable strings category methods tests * Ensure escape, pad, padEnd, padStart, trim, trimEnd, trimStart, unescape return an empty string for falsey values * Coerce value to string using toString in truncate, capitalize and case methods * Ensure createCaseFirst returns an empty string for falsey values
39 lines
987 B
JavaScript
39 lines
987 B
JavaScript
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
|