[d24f17c] | 1 | import { curryN, map, range, always } from 'ramda';
|
---|
| 2 | import floor from './floor';
|
---|
| 3 |
|
---|
| 4 | /**
|
---|
| 5 | * Creates an array of numbers (positive and/or negative) progressing from start up to, but not including, end.
|
---|
| 6 | *
|
---|
| 7 | * `Note`: JavaScript follows the IEEE-754 standard for resolving floating-point values which can produce unexpected results.
|
---|
| 8 | *
|
---|
| 9 | * @func rangeStep
|
---|
| 10 | * @memberOf RA
|
---|
| 11 | * @category List
|
---|
| 12 | * @since {@link https://char0n.github.io/ramda-adjunct/2.30.0|v2.30.0}
|
---|
| 13 | * @sig Number -> Number -> Number -> [Number]
|
---|
| 14 | * @param {number} step The value to increment or decrement by
|
---|
| 15 | * @param {number} from The start of the range
|
---|
| 16 | * @param {number} to The end of the range
|
---|
| 17 | * @return {number[]} Returns the range of numbers
|
---|
| 18 | * @see {@link http://ramdajs.com/docs/#range|R.range}
|
---|
| 19 | * @example
|
---|
| 20 | *
|
---|
| 21 | * RA.rangeStep(1, 0, 4); // => [0, 1 ,2, 3]
|
---|
| 22 | * RA.rangeStep(-1, 0, -4); // => [0, -1, -2, -3]
|
---|
| 23 | * RA.rangeStep(1, 1, 5); // => [1, 2, 3, 4]
|
---|
| 24 | * RA.rangeStep(5, 0, 20); // => [0, 5, 10, 15]
|
---|
| 25 | * RA.rangeStep(-1, 0, -4); // => [0, -1, -2, -3]
|
---|
| 26 | * RA.rangeStep(0, 1, 4); // => [1, 1, 1]
|
---|
| 27 | * RA.rangeStep(1, 0, 0); // => []
|
---|
| 28 | */
|
---|
| 29 | var rangeStep = curryN(3, function (step, from, to) {
|
---|
| 30 | var callback = step === 0 ? always(from) : function (n) {
|
---|
| 31 | return from + step * n;
|
---|
| 32 | };
|
---|
| 33 | var rangeEnd = step === 0 ? to - from : floor((to - from) / step);
|
---|
| 34 | return map(callback, range(0, rangeEnd));
|
---|
| 35 | });
|
---|
| 36 | export default rangeStep; |
---|