81ea0dd552dbe2bd43727160f9307aad2796da86
[yaffs-website] / node_modules / grunt-legacy-util / node_modules / lodash / reject.js
1 var arrayFilter = require('./_arrayFilter'),
2     baseFilter = require('./_baseFilter'),
3     baseIteratee = require('./_baseIteratee'),
4     isArray = require('./isArray');
5
6 /**
7  * The opposite of `_.filter`; this method returns the elements of `collection`
8  * that `predicate` does **not** return truthy for.
9  *
10  * @static
11  * @memberOf _
12  * @category Collection
13  * @param {Array|Object} collection The collection to iterate over.
14  * @param {Function|Object|string} [predicate=_.identity] The function invoked per iteration.
15  * @returns {Array} Returns the new filtered array.
16  * @example
17  *
18  * var users = [
19  *   { 'user': 'barney', 'age': 36, 'active': false },
20  *   { 'user': 'fred',   'age': 40, 'active': true }
21  * ];
22  *
23  * _.reject(users, function(o) { return !o.active; });
24  * // => objects for ['fred']
25  *
26  * // The `_.matches` iteratee shorthand.
27  * _.reject(users, { 'age': 40, 'active': true });
28  * // => objects for ['barney']
29  *
30  * // The `_.matchesProperty` iteratee shorthand.
31  * _.reject(users, ['active', false]);
32  * // => objects for ['fred']
33  *
34  * // The `_.property` iteratee shorthand.
35  * _.reject(users, 'active');
36  * // => objects for ['barney']
37  */
38 function reject(collection, predicate) {
39   var func = isArray(collection) ? arrayFilter : baseFilter;
40   predicate = baseIteratee(predicate, 3);
41   return func(collection, function(value, index, collection) {
42     return !predicate(value, index, collection);
43   });
44 }
45
46 module.exports = reject;