www.aleph1.co.uk Git - yaffs-website/blob - node_modules/grunt-contrib-watch/node_modules/globule/node_modules/lodash/findIndex.js

   1 var baseFindIndex = require('./_baseFindIndex'),
   2     baseIteratee = require('./_baseIteratee'),
   3     toInteger = require('./toInteger');
   4
   5 /* Built-in method references for those with the same name as other `lodash` methods. */
   6 var nativeMax = Math.max;
   7
   8 /**
   9  * This method is like `_.find` except that it returns the index of the first
  10  * element `predicate` returns truthy for instead of the element itself.
  11  *
  12  * @static
  13  * @memberOf _
  14  * @since 1.1.0
  15  * @category Array
  16  * @param {Array} array The array to inspect.
  17  * @param {Function} [predicate=_.identity] The function invoked per iteration.
  18  * @param {number} [fromIndex=0] The index to search from.
  19  * @returns {number} Returns the index of the found element, else `-1`.
  20  * @example
  21  *
  22  * var users = [
  23  *   { 'user': 'barney',  'active': false },
  24  *   { 'user': 'fred',    'active': false },
  25  *   { 'user': 'pebbles', 'active': true }
  26  * ];
  27  *
  28  * _.findIndex(users, function(o) { return o.user == 'barney'; });
  29  * // => 0
  30  *
  31  * // The `_.matches` iteratee shorthand.
  32  * _.findIndex(users, { 'user': 'fred', 'active': false });
  33  * // => 1
  34  *
  35  * // The `_.matchesProperty` iteratee shorthand.
  36  * _.findIndex(users, ['active', false]);
  37  * // => 0
  38  *
  39  * // The `_.property` iteratee shorthand.
  40  * _.findIndex(users, 'active');
  41  * // => 2
  42  */
  43 function findIndex(array, predicate, fromIndex) {
  44   var length = array == null ? 0 : array.length;
  45   if (!length) {
  46     return -1;
  47   }
  48   var index = fromIndex == null ? 0 : toInteger(fromIndex);
  49   if (index < 0) {
  50     index = nativeMax(length + index, 0);
  51   }
  52   return baseFindIndex(array, baseIteratee(predicate, 3), index);
  53 }
  54
  55 module.exports = findIndex;