www.aleph1.co.uk Git - yaffs-website/blob - node_modules/uncss/node_modules/lodash/padStart.js

   1 var createPadding = require('./internal/createPadding'),
   2     toString = require('./toString');
   3
   4 /**
   5  * Pads `string` on the left side if it's shorter than `length`. Padding
   6  * characters are truncated if they exceed `length`.
   7  *
   8  * @static
   9  * @memberOf _
  10  * @category String
  11  * @param {string} [string=''] The string to pad.
  12  * @param {number} [length=0] The padding length.
  13  * @param {string} [chars=' '] The string used as padding.
  14  * @returns {string} Returns the padded string.
  15  * @example
  16  *
  17  * _.padStart('abc', 6);
  18  * // => '   abc'
  19  *
  20  * _.padStart('abc', 6, '_-');
  21  * // => '_-_abc'
  22  *
  23  * _.padStart('abc', 3);
  24  * // => 'abc'
  25  */
  26 function padStart(string, length, chars) {
  27   string = toString(string);
  28   return createPadding(string, length, chars) + string;
  29 }
  30
  31 module.exports = padStart;