1 var baseRest = require('./_baseRest'),
2 toInteger = require('./toInteger');
4 /** Error message constants. */
5 var FUNC_ERROR_TEXT = 'Expected a function';
8 * Creates a function that invokes `func` with the `this` binding of the
9 * created function and arguments from `start` and beyond provided as
12 * **Note:** This method is based on the
13 * [rest parameter](https://mdn.io/rest_parameters).
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.
24 * var say = _.rest(function(what, names) {
25 * return what + ' ' + _.initial(names).join(', ') +
26 * (_.size(names) > 1 ? ', & ' : '') + _.last(names);
29 * say('hello', 'fred', 'barney', 'pebbles');
30 * // => 'hello fred, barney, & pebbles'
32 function rest(func, start) {
33 if (typeof func != 'function') {
34 throw new TypeError(FUNC_ERROR_TEXT);
36 start = start === undefined ? start : toInteger(start);
37 return baseRest(func, start);
40 module.exports = rest;