Tolan/frontend/node_modules/underscore/amd/_extremum.js

define(['./identity', './_cb', './find'], function (identity, _cb, find) {

  // The general algorithm behind `_.min` and `_.max`. `compare` should return
  // `true` if its first argument is more extreme than (i.e., should be preferred
  // over) its second argument, `false` otherwise. `iteratee` and `context`, like
  // in other collection functions, let you map the actual values in `collection`
  // to the values to `compare`. `decide` is an optional customization point
  // which is only present for historical reasons; please don't use it, as it will
  // likely be removed in the future.
  function extremum(collection, compare, iteratee, context, decide) {
    decide || (decide = identity);
    // `extremum` is essentially a combined map+reduce with **two** accumulators:
    // `result` and `iterResult`, respectively the unmapped and the mapped version
    // corresponding to the same element.
    var result, iterResult;
    iteratee = _cb(iteratee, context);
    var first = true;
    find(collection, function(value, key) {
      var iterValue = iteratee(value, key, collection);
      if (first || compare(iterValue, iterResult)) {
        result = value;
        iterResult = iterValue;
        first = false;
      }
    });
    // `extremum` normally returns an unmapped element from `collection`. However,
    // `_.min` and `_.max` forcibly return a number even if there is no element
    // that maps to a numeric value. Passing both accumulators through `decide`
    // before returning enables this behavior.
    return decide(result, iterResult);
  }

  return extremum;

});