df37ded03dc281de69bc2a2f08e909720d9c5a27
[platform/framework/web/crosswalk-tizen.git] /
1 var baseToString = require('../internal/baseToString'),
2     createPadding = require('../internal/createPadding');
3
4 /** Native method references. */
5 var ceil = Math.ceil,
6     floor = Math.floor;
7
8 /* Native method references for those with the same name as other `lodash` methods. */
9 var nativeIsFinite = global.isFinite;
10
11 /**
12  * Pads `string` on the left and right sides if it is shorter than `length`.
13  * Padding characters are truncated if they can't be evenly divided by `length`.
14  *
15  * @static
16  * @memberOf _
17  * @category String
18  * @param {string} [string=''] The string to pad.
19  * @param {number} [length=0] The padding length.
20  * @param {string} [chars=' '] The string used as padding.
21  * @returns {string} Returns the padded string.
22  * @example
23  *
24  * _.pad('abc', 8);
25  * // => '  abc   '
26  *
27  * _.pad('abc', 8, '_-');
28  * // => '_-abc_-_'
29  *
30  * _.pad('abc', 3);
31  * // => 'abc'
32  */
33 function pad(string, length, chars) {
34   string = baseToString(string);
35   length = +length;
36
37   var strLength = string.length;
38   if (strLength >= length || !nativeIsFinite(length)) {
39     return string;
40   }
41   var mid = (length - strLength) / 2,
42       leftLength = floor(mid),
43       rightLength = ceil(mid);
44
45   chars = createPadding('', rightLength, chars);
46   return chars.slice(0, leftLength) + string + chars;
47 }
48
49 module.exports = pad;