1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374 |
- import _clone from "./internal/_clone.js";
- import _curryN from "./internal/_curryN.js";
- import _dispatchable from "./internal/_dispatchable.js";
- import _has from "./internal/_has.js";
- import _reduced from "./internal/_reduced.js";
- import _xReduce from "./internal/_xReduce.js";
- import _xreduceBy from "./internal/_xreduceBy.js";
- import _xwrap from "./internal/_xwrap.js";
- /**
- * Groups the elements of the list according to the result of calling
- * the String-returning function `keyFn` on each element and reduces the elements
- * of each group to a single value via the reducer function `valueFn`.
- *
- * The value function receives two values: *(acc, value)*. It may use
- * [`R.reduced`](#reduced) to short circuit the iteration.
- *
- * This function is basically a more general [`groupBy`](#groupBy) function.
- *
- * Acts as a transducer if a transformer is given in list position.
- *
- * @func
- * @memberOf R
- * @since v0.20.0
- * @category List
- * @sig ((a, b) -> a) -> a -> (b -> String) -> [b] -> {String: a}
- * @param {Function} valueFn The function that reduces the elements of each group to a single
- * value. Receives two values, accumulator for a particular group and the current element.
- * @param {*} acc The (initial) accumulator value for each group.
- * @param {Function} keyFn The function that maps the list's element into a key.
- * @param {Array} list The array to group.
- * @return {Object} An object with the output of `keyFn` for keys, mapped to the output of
- * `valueFn` for elements which produced that key when passed to `keyFn`.
- * @see R.groupBy, R.reduce, R.reduced
- * @example
- *
- * const groupNames = (acc, {name}) => acc.concat(name)
- * const toGrade = ({score}) =>
- * score < 65 ? 'F' :
- * score < 70 ? 'D' :
- * score < 80 ? 'C' :
- * score < 90 ? 'B' : 'A'
- *
- * var students = [
- * {name: 'Abby', score: 83},
- * {name: 'Bart', score: 62},
- * {name: 'Curt', score: 88},
- * {name: 'Dora', score: 92},
- * ]
- *
- * reduceBy(groupNames, [], toGrade, students)
- * //=> {"A": ["Dora"], "B": ["Abby", "Curt"], "F": ["Bart"]}
- */
- var reduceBy =
- /*#__PURE__*/
- _curryN(4, [],
- /*#__PURE__*/
- _dispatchable([], _xreduceBy, function reduceBy(valueFn, valueAcc, keyFn, list) {
- var xf = _xwrap(function (acc, elt) {
- var key = keyFn(elt);
- var value = valueFn(_has(key, acc) ? acc[key] : _clone(valueAcc, false), elt);
- if (value && value['@@transducer/reduced']) {
- return _reduced(acc);
- }
- acc[key] = value;
- return acc;
- });
- return _xReduce(xf, {}, list);
- }));
- export default reduceBy;
|