Bump to v3.0.0.

string/pad.js

@@ -0,0 +1,50 @@
+define(['../internal/baseToString', '../internal/createPad', '../internal/root'], function(baseToString, createPad, root) {
+
+  /** Native method references. */
+  var ceil = Math.ceil,
+      floor = Math.floor;
+
+  /* Native method references for those with the same name as other `lodash` methods. */
+  var nativeIsFinite = root.isFinite;
+
+  /**
+   * Pads `string` on the left and right sides if it is shorter then the given
+   * padding length. The `chars` string may be truncated if the number of padding
+   * characters can't be evenly divided by the padding length.
+   *
+   * @static
+   * @memberOf _
+   * @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', 3);
+   * // => 'abc'
+   */
+  function pad(string, length, chars) {
+    string = baseToString(string);
+    length = +length;
+
+    var strLength = string.length;
+    if (strLength >= length || !nativeIsFinite(length)) {
+      return string;
+    }
+    var mid = (length - strLength) / 2,
+        leftLength = floor(mid),
+        rightLength = ceil(mid);
+
+    chars = createPad('', rightLength, chars);
+    return chars.slice(0, leftLength) + string + chars;
+  }
+
+  return pad;
+});