time-to-botec

Benchmark sampling in different programming languages
Log | Files | Refs | README

rest.js (1182B)

      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;