You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
75 lines
1.7 KiB
75 lines
1.7 KiB
var iterate = require('./lib/iterate.js') |
|
, initState = require('./lib/state.js') |
|
, terminator = require('./lib/terminator.js') |
|
; |
|
|
|
// Public API |
|
module.exports = serialOrdered; |
|
// sorting helpers |
|
module.exports.ascending = ascending; |
|
module.exports.descending = descending; |
|
|
|
/** |
|
* Runs iterator over provided sorted array elements in series |
|
* |
|
* @param {array|object} list - array or object (named list) to iterate over |
|
* @param {function} iterator - iterator to run |
|
* @param {function} sortMethod - custom sort function |
|
* @param {function} callback - invoked when all elements processed |
|
* @returns {function} - jobs terminator |
|
*/ |
|
function serialOrdered(list, iterator, sortMethod, callback) |
|
{ |
|
var state = initState(list, sortMethod); |
|
|
|
iterate(list, iterator, state, function iteratorHandler(error, result) |
|
{ |
|
if (error) |
|
{ |
|
callback(error, result); |
|
return; |
|
} |
|
|
|
state.index++; |
|
|
|
// are we there yet? |
|
if (state.index < (state['keyedList'] || list).length) |
|
{ |
|
iterate(list, iterator, state, iteratorHandler); |
|
return; |
|
} |
|
|
|
// done here |
|
callback(null, state.results); |
|
}); |
|
|
|
return terminator.bind(state, callback); |
|
} |
|
|
|
/* |
|
* -- Sort methods |
|
*/ |
|
|
|
/** |
|
* sort helper to sort array elements in ascending order |
|
* |
|
* @param {mixed} a - an item to compare |
|
* @param {mixed} b - an item to compare |
|
* @returns {number} - comparison result |
|
*/ |
|
function ascending(a, b) |
|
{ |
|
return a < b ? -1 : a > b ? 1 : 0; |
|
} |
|
|
|
/** |
|
* sort helper to sort array elements in descending order |
|
* |
|
* @param {mixed} a - an item to compare |
|
* @param {mixed} b - an item to compare |
|
* @returns {number} - comparison result |
|
*/ |
|
function descending(a, b) |
|
{ |
|
return -1 * ascending(a, b); |
|
}
|
|
|