1 | import identity from './identity';
|
2 | import partial from './partial';
|
3 |
|
4 | /**
|
5 | * Creates a function that provides `value` to the wrapper function as its
|
6 | * first argument. Any additional arguments provided to the function are
|
7 | * appended to those provided to the wrapper function. The wrapper is invoked
|
8 | * with the `this` binding of the created function.
|
9 | *
|
10 | * @static
|
11 | * @memberOf _
|
12 | * @since 0.1.0
|
13 | * @category Function
|
14 | * @param {*} value The value to wrap.
|
15 | * @param {Function} [wrapper=identity] The wrapper function.
|
16 | * @returns {Function} Returns the new function.
|
17 | * @example
|
18 | *
|
19 | * var p = _.wrap(_.escape, function(func, text) {
|
20 | * return '<p>' + func(text) + '</p>';
|
21 | * });
|
22 | *
|
23 | * p('fred, barney, & pebbles');
|
24 | * // => '<p>fred, barney, & pebbles</p>'
|
25 | */
|
26 | function wrap(value, wrapper) {
|
27 | wrapper = wrapper == null ? identity : wrapper;
|
28 | return partial(wrapper, value);
|
29 | }
|
30 |
|
31 | export default wrap;
|