www.aleph1.co.uk Git - yaffs-website/blob - node_modules/sass-graph/node_modules/lodash/iteratee.js

   1 var baseClone = require('./_baseClone'),
   2     baseIteratee = require('./_baseIteratee');
   3
   4 /** Used to compose bitmasks for cloning. */
   5 var CLONE_DEEP_FLAG = 1;
   6
   7 /**
   8  * Creates a function that invokes `func` with the arguments of the created
   9  * function. If `func` is a property name, the created function returns the
  10  * property value for a given element. If `func` is an array or object, the
  11  * created function returns `true` for elements that contain the equivalent
  12  * source properties, otherwise it returns `false`.
  13  *
  14  * @static
  15  * @since 4.0.0
  16  * @memberOf _
  17  * @category Util
  18  * @param {*} [func=_.identity] The value to convert to a callback.
  19  * @returns {Function} Returns the callback.
  20  * @example
  21  *
  22  * var users = [
  23  *   { 'user': 'barney', 'age': 36, 'active': true },
  24  *   { 'user': 'fred',   'age': 40, 'active': false }
  25  * ];
  26  *
  27  * // The `_.matches` iteratee shorthand.
  28  * _.filter(users, _.iteratee({ 'user': 'barney', 'active': true }));
  29  * // => [{ 'user': 'barney', 'age': 36, 'active': true }]
  30  *
  31  * // The `_.matchesProperty` iteratee shorthand.
  32  * _.filter(users, _.iteratee(['user', 'fred']));
  33  * // => [{ 'user': 'fred', 'age': 40 }]
  34  *
  35  * // The `_.property` iteratee shorthand.
  36  * _.map(users, _.iteratee('user'));
  37  * // => ['barney', 'fred']
  38  *
  39  * // Create custom iteratee shorthands.
  40  * _.iteratee = _.wrap(_.iteratee, function(iteratee, func) {
  41  *   return !_.isRegExp(func) ? iteratee(func) : function(string) {
  42  *     return func.test(string);
  43  *   };
  44  * });
  45  *
  46  * _.filter(['abc', 'def'], /ef/);
  47  * // => ['def']
  48  */
  49 function iteratee(func) {
  50   return baseIteratee(typeof func == 'function' ? func : baseClone(func, CLONE_DEEP_FLAG));
  51 }
  52
  53 module.exports = iteratee;