33 lines
1.1 KiB
JavaScript
33 lines
1.1 KiB
JavaScript
import _curry2 from './internal/_curry2';
|
|
import map from './map';
|
|
import prop from './prop';
|
|
|
|
/**
|
|
* Returns a new list by plucking the same named property off all objects in
|
|
* the list supplied.
|
|
*
|
|
* `pluck` will work on
|
|
* any [functor](https://github.com/fantasyland/fantasy-land#functor) in
|
|
* addition to arrays, as it is equivalent to `R.map(R.prop(k), f)`.
|
|
*
|
|
* @func
|
|
* @memberOf R
|
|
* @since v0.1.0
|
|
* @category List
|
|
* @sig Functor f => k -> f {k: v} -> f v
|
|
* @param {Number|String} key The key name to pluck off of each object.
|
|
* @param {Array} f The array or functor to consider.
|
|
* @return {Array} The list of values for the given key.
|
|
* @see R.props
|
|
* @example
|
|
*
|
|
* R.pluck('a')([{a: 1}, {a: 2}]); //=> [1, 2]
|
|
* R.pluck(0)([[1, 2], [3, 4]]); //=> [1, 3]
|
|
* R.pluck('val', {a: {val: 3}, b: {val: 5}}); //=> {a: 3, b: 5}
|
|
* @symb R.pluck('x', [{x: 1, y: 2}, {x: 3, y: 4}, {x: 5, y: 6}]) = [1, 3, 5]
|
|
* @symb R.pluck(0, [[1, 2], [3, 4], [5, 6]]) = [1, 3, 5]
|
|
*/
|
|
var pluck = /*#__PURE__*/_curry2(function pluck(p, list) {
|
|
return map(prop(p), list);
|
|
});
|
|
export default pluck; |