www.aleph1.co.uk Git - yaffs-website/blob - node_modules/sass-graph/node_modules/lodash/spread.js

   1 var apply = require('./_apply'),
   2     arrayPush = require('./_arrayPush'),
   3     baseRest = require('./_baseRest'),
   4     castSlice = require('./_castSlice'),
   5     toInteger = require('./toInteger');
   6
   7 /** Error message constants. */
   8 var FUNC_ERROR_TEXT = 'Expected a function';
   9
  10 /* Built-in method references for those with the same name as other `lodash` methods. */
  11 var nativeMax = Math.max;
  12
  13 /**
  14  * Creates a function that invokes `func` with the `this` binding of the
  15  * create function and an array of arguments much like
  16  * [`Function#apply`](http://www.ecma-international.org/ecma-262/7.0/#sec-function.prototype.apply).
  17  *
  18  * **Note:** This method is based on the
  19  * [spread operator](https://mdn.io/spread_operator).
  20  *
  21  * @static
  22  * @memberOf _
  23  * @since 3.2.0
  24  * @category Function
  25  * @param {Function} func The function to spread arguments over.
  26  * @param {number} [start=0] The start position of the spread.
  27  * @returns {Function} Returns the new function.
  28  * @example
  29  *
  30  * var say = _.spread(function(who, what) {
  31  *   return who + ' says ' + what;
  32  * });
  33  *
  34  * say(['fred', 'hello']);
  35  * // => 'fred says hello'
  36  *
  37  * var numbers = Promise.all([
  38  *   Promise.resolve(40),
  39  *   Promise.resolve(36)
  40  * ]);
  41  *
  42  * numbers.then(_.spread(function(x, y) {
  43  *   return x + y;
  44  * }));
  45  * // => a Promise of 76
  46  */
  47 function spread(func, start) {
  48   if (typeof func != 'function') {
  49     throw new TypeError(FUNC_ERROR_TEXT);
  50   }
  51   start = start == null ? 0 : nativeMax(toInteger(start), 0);
  52   return baseRest(function(args) {
  53     var array = args[start],
  54         otherArgs = castSlice(args, 0, start);
  55
  56     if (array) {
  57       arrayPush(otherArgs, array);
  58     }
  59     return apply(func, this, otherArgs);
  60   });
  61 }
  62
  63 module.exports = spread;