| /** |
| * Lo-Dash 2.4.1 (Custom Build) <http://lodash.com/> |
| * Build: `lodash modularize exports="node" -o ./compat/` |
| * Copyright 2012-2013 The Dojo Foundation <http://dojofoundation.org/> |
| * Based on Underscore.js 1.5.2 <http://underscorejs.org/LICENSE> |
| * Copyright 2009-2013 Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors |
| * Available under MIT license <http://lodash.com/license> |
| */ |
| var baseCreateCallback = require('../internals/baseCreateCallback'), |
| baseEach = require('../internals/baseEach'), |
| isArray = require('../objects/isArray'), |
| isString = require('../objects/isString'), |
| keys = require('../objects/keys'), |
| support = require('../support'); |
| |
| /** |
| * This method is like `_.forEach` except that it iterates over elements |
| * of a `collection` from right to left. |
| * |
| * @static |
| * @memberOf _ |
| * @alias eachRight |
| * @category Collections |
| * @param {Array|Object|string} collection The collection to iterate over. |
| * @param {Function} [callback=identity] The function called per iteration. |
| * @param {*} [thisArg] The `this` binding of `callback`. |
| * @returns {Array|Object|string} Returns `collection`. |
| * @example |
| * |
| * _([1, 2, 3]).forEachRight(function(num) { console.log(num); }).join(','); |
| * // => logs each number from right to left and returns '3,2,1' |
| */ |
| function forEachRight(collection, callback, thisArg) { |
| var iterable = collection, |
| length = collection ? collection.length : 0; |
| |
| callback = callback && typeof thisArg == 'undefined' ? callback : baseCreateCallback(callback, thisArg, 3); |
| if (isArray(collection)) { |
| while (length--) { |
| if (callback(collection[length], length, collection) === false) { |
| break; |
| } |
| } |
| } else { |
| if (typeof length != 'number') { |
| var props = keys(collection); |
| length = props.length; |
| } else if (support.unindexedChars && isString(collection)) { |
| iterable = collection.split(''); |
| } |
| baseEach(collection, function(value, key, collection) { |
| key = props ? props[--length] : --length; |
| return callback(iterable[key], key, collection); |
| }); |
| } |
| return collection; |
| } |
| |
| module.exports = forEachRight; |