| 1 | var iterate = require('./lib/iterate.js') |
| 2 | , initState = require('./lib/state.js') |
| 3 | , terminator = require('./lib/terminator.js') |
| 4 | ; |
| 5 | |
| 6 | // Public API |
| 7 | module.exports = serialOrdered; |
| 8 | // sorting helpers |
| 9 | module.exports.ascending = ascending; |
| 10 | module.exports.descending = descending; |
| 11 | |
| 12 | /** |
| 13 | * Runs iterator over provided sorted array elements in series |
| 14 | * |
| 15 | * @param {array|object} list - array or object (named list) to iterate over |
| 16 | * @param {function} iterator - iterator to run |
| 17 | * @param {function} sortMethod - custom sort function |
| 18 | * @param {function} callback - invoked when all elements processed |
| 19 | * @returns {function} - jobs terminator |
| 20 | */ |
| 21 | function serialOrdered(list, iterator, sortMethod, callback) |
| 22 | { |
| 23 | var state = initState(list, sortMethod); |
| 24 | |
| 25 | iterate(list, iterator, state, function iteratorHandler(error, result) |
| 26 | { |
| 27 | if (error) |
| 28 | { |
| 29 | callback(error, result); |
| 30 | return; |
| 31 | } |
| 32 | |
| 33 | state.index++; |
| 34 | |
| 35 | // are we there yet? |
| 36 | if (state.index < (state['keyedList'] || list).length) |
| 37 | { |
| 38 | iterate(list, iterator, state, iteratorHandler); |
| 39 | return; |
| 40 | } |
| 41 | |
| 42 | // done here |
| 43 | callback(null, state.results); |
| 44 | }); |
| 45 | |
| 46 | return terminator.bind(state, callback); |
| 47 | } |
| 48 | |
| 49 | /* |
| 50 | * -- Sort methods |
| 51 | */ |
| 52 | |
| 53 | /** |
| 54 | * sort helper to sort array elements in ascending order |
| 55 | * |
| 56 | * @param {mixed} a - an item to compare |
| 57 | * @param {mixed} b - an item to compare |
| 58 | * @returns {number} - comparison result |
| 59 | */ |
| 60 | function ascending(a, b) |
| 61 | { |
| 62 | return a < b ? -1 : a > b ? 1 : 0; |
| 63 | } |
| 64 | |
| 65 | /** |
| 66 | * sort helper to sort array elements in descending order |
| 67 | * |
| 68 | * @param {mixed} a - an item to compare |
| 69 | * @param {mixed} b - an item to compare |
| 70 | * @returns {number} - comparison result |
| 71 | */ |
| 72 | function descending(a, b) |
| 73 | { |
| 74 | return -1 * ascending(a, b); |
| 75 | } |