rest.js
 1  var baseRest = require('./_baseRest'),
 2      toInteger = require('./toInteger');
 3  
 4  /** Error message constants. */
 5  var FUNC_ERROR_TEXT = 'Expected a function';
 6  
 7  /**
 8   * Creates a function that invokes `func` with the `this` binding of the
 9   * created function and arguments from `start` and beyond provided as
10   * an array.
11   *
12   * **Note:** This method is based on the
13   * [rest parameter](https://mdn.io/rest_parameters).
14   *
15   * @static
16   * @memberOf _
17   * @since 4.0.0
18   * @category Function
19   * @param {Function} func The function to apply a rest parameter to.
20   * @param {number} [start=func.length-1] The start position of the rest parameter.
21   * @returns {Function} Returns the new function.
22   * @example
23   *
24   * var say = _.rest(function(what, names) {
25   *   return what + ' ' + _.initial(names).join(', ') +
26   *     (_.size(names) > 1 ? ', & ' : '') + _.last(names);
27   * });
28   *
29   * say('hello', 'fred', 'barney', 'pebbles');
30   * // => 'hello fred, barney, & pebbles'
31   */
32  function rest(func, start) {
33    if (typeof func != 'function') {
34      throw new TypeError(FUNC_ERROR_TEXT);
35    }
36    start = start === undefined ? start : toInteger(start);
37    return baseRest(func, start);
38  }
39  
40  module.exports = rest;