www.aleph1.co.uk Git - yaffs-website/blob - node_modules/grunt-legacy-log-utils/node_modules/lodash/mergeWith.js

   1 var baseMerge = require('./_baseMerge'),
   2     createAssigner = require('./_createAssigner');
   3
   4 /**
   5  * This method is like `_.merge` except that it accepts `customizer` which
   6  * is invoked to produce the merged values of the destination and source
   7  * properties. If `customizer` returns `undefined` merging is handled by the
   8  * method instead. The `customizer` is invoked with seven arguments:
   9  * (objValue, srcValue, key, object, source, stack).
  10  *
  11  * **Note:** This method mutates `object`.
  12  *
  13  * @static
  14  * @memberOf _
  15  * @category Object
  16  * @param {Object} object The destination object.
  17  * @param {...Object} sources The source objects.
  18  * @param {Function} customizer The function to customize assigned values.
  19  * @returns {Object} Returns `object`.
  20  * @example
  21  *
  22  * function customizer(objValue, srcValue) {
  23  *   if (_.isArray(objValue)) {
  24  *     return objValue.concat(srcValue);
  25  *   }
  26  * }
  27  *
  28  * var object = {
  29  *   'fruits': ['apple'],
  30  *   'vegetables': ['beet']
  31  * };
  32  *
  33  * var other = {
  34  *   'fruits': ['banana'],
  35  *   'vegetables': ['carrot']
  36  * };
  37  *
  38  * _.mergeWith(object, other, customizer);
  39  * // => { 'fruits': ['apple', 'banana'], 'vegetables': ['beet', 'carrot'] }
  40  */
  41 var mergeWith = createAssigner(function(object, source, srcIndex, customizer) {
  42   baseMerge(object, source, srcIndex, customizer);
  43 });
  44
  45 module.exports = mergeWith;