diff options
Diffstat (limited to 'node_modules/lodash/rest.js')
-rw-r--r-- | node_modules/lodash/rest.js | 40 |
1 files changed, 40 insertions, 0 deletions
diff --git a/node_modules/lodash/rest.js b/node_modules/lodash/rest.js new file mode 100644 index 0000000..eaaad00 --- /dev/null +++ b/node_modules/lodash/rest.js @@ -0,0 +1,40 @@ +var baseRest = require('./_baseRest'), + toInteger = require('./toInteger'); + +/** Error message constants. */ +var FUNC_ERROR_TEXT = 'Expected a function'; + +/** + * Creates a function that invokes `func` with the `this` binding of the + * created function and arguments from `start` and beyond provided as + * an array. + * + * **Note:** This method is based on the + * [rest parameter](https://mdn.io/rest_parameters). + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Function + * @param {Function} func The function to apply a rest parameter to. + * @param {number} [start=func.length-1] The start position of the rest parameter. + * @returns {Function} Returns the new function. + * @example + * + * var say = _.rest(function(what, names) { + * return what + ' ' + _.initial(names).join(', ') + + * (_.size(names) > 1 ? ', & ' : '') + _.last(names); + * }); + * + * say('hello', 'fred', 'barney', 'pebbles'); + * // => 'hello fred, barney, & pebbles' + */ +function rest(func, start) { + if (typeof func != 'function') { + throw new TypeError(FUNC_ERROR_TEXT); + } + start = start === undefined ? start : toInteger(start); + return baseRest(func, start); +} + +module.exports = rest; |