d100d0dbe670a8a535534a5b0763f585fd4502dc
[yaffs-website] / node_modules / grunt-legacy-util / node_modules / lodash / every.js
1 var arrayEvery = require('./_arrayEvery'),
2     baseEvery = require('./_baseEvery'),
3     baseIteratee = require('./_baseIteratee'),
4     isArray = require('./isArray'),
5     isIterateeCall = require('./_isIterateeCall');
6
7 /**
8  * Checks if `predicate` returns truthy for **all** elements of `collection`.
9  * Iteration is stopped once `predicate` returns falsey. The predicate is
10  * invoked with three arguments: (value, index|key, collection).
11  *
12  * @static
13  * @memberOf _
14  * @category Collection
15  * @param {Array|Object} collection The collection to iterate over.
16  * @param {Function|Object|string} [predicate=_.identity] The function invoked per iteration.
17  * @param- {Object} [guard] Enables use as an iteratee for functions like `_.map`.
18  * @returns {boolean} Returns `true` if all elements pass the predicate check, else `false`.
19  * @example
20  *
21  * _.every([true, 1, null, 'yes'], Boolean);
22  * // => false
23  *
24  * var users = [
25  *   { 'user': 'barney', 'active': false },
26  *   { 'user': 'fred',   'active': false }
27  * ];
28  *
29  * // The `_.matches` iteratee shorthand.
30  * _.every(users, { 'user': 'barney', 'active': false });
31  * // => false
32  *
33  * // The `_.matchesProperty` iteratee shorthand.
34  * _.every(users, ['active', false]);
35  * // => true
36  *
37  * // The `_.property` iteratee shorthand.
38  * _.every(users, 'active');
39  * // => false
40  */
41 function every(collection, predicate, guard) {
42   var func = isArray(collection) ? arrayEvery : baseEvery;
43   if (guard && isIterateeCall(collection, predicate, guard)) {
44     predicate = undefined;
45   }
46   return func(collection, baseIteratee(predicate, 3));
47 }
48
49 module.exports = every;