| var baseClone = require('./_baseClone'), | |
| baseMatches = require('./_baseMatches'); | |
| /** Used to compose bitmasks for cloning. */ | |
| var CLONE_DEEP_FLAG = 1; | |
| /** | |
| * Creates a function that performs a partial deep comparison between a given | |
| * object and `source`, returning `true` if the given object has equivalent | |
| * property values, else `false`. | |
| * | |
| * **Note:** The created function is equivalent to `_.isMatch` with `source` | |
| * partially applied. | |
| * | |
| * Partial comparisons will match empty array and empty object `source` | |
| * values against any array or object value, respectively. See `_.isEqual` | |
| * for a list of supported value comparisons. | |
| * | |
| * @static | |
| * @memberOf _ | |
| * @since 3.0.0 | |
| * @category Util | |
| * @param {Object} source The object of property values to match. | |
| * @returns {Function} Returns the new spec function. | |
| * @example | |
| * | |
| * var objects = [ | |
| * { 'a': 1, 'b': 2, 'c': 3 }, | |
| * { 'a': 4, 'b': 5, 'c': 6 } | |
| * ]; | |
| * | |
| * _.filter(objects, _.matches({ 'a': 4, 'c': 6 })); | |
| * // => [{ 'a': 4, 'b': 5, 'c': 6 }] | |
| */ | |
| function matches(source) { | |
| return baseMatches(baseClone(source, CLONE_DEEP_FLAG)); | |
| } | |
| module.exports = matches; |