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;
|
---|