_.range & _.rangeRight behavior for step=0 not explained in documentation #5944

emiliodacosta · 2024-11-27T20:03:51Z

Regarding expected behavior when step=0, the documentation shows the following for _.range and _.rangeRight :

_.range(1, 4, 0);
// => [1, 1, 1]

_.rangeRight(1, 4, 0);
// => [1, 1, 1]

However, it doesn't include any verbal explanation or code examples demonstrating expected behavior when given an input with start > end and step = 0.

Accordingly, my initial expectation was that the following 4 invocations of both _.range and _.rangeRight would each result in the following identical outputs:

[-4, -4]
[-2, -2]
[2, 2]
[4, 4]

Instead, the actual behavior is the following:

_.range(-4, -2, 0);
// => [-4, -4]
_.range(-2, -4, 0);
// => []
_.range(2, 4, 0);
// => [2, 2]
_.range(4, 2, 0);
// => []

_.rangeRight(-4, -2, 0);
// => [-4, -4]
_.rangeRight(-2, -4, 0);
// => []
_.rangeRight(2, 4, 0);
// => [2, 2]
_.rangeRight(4, 2, 0);
// => []

Apparently, I seem to have proven that the expected output for both _.range and _.rangeRight is [] whenever start > end and step = 0.

It would be nice if this were explained and/or demonstrated in the documentation so that, going forward, individuals like myself wouldn't have to investigate the ambiguity of these two otherwise very useful methods in an otherwise very well-documented library.

Thank you!

The text was updated successfully, but these errors were encountered:

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

_.range & _.rangeRight behavior for step=0 not explained in documentation #5944

_.range & _.rangeRight behavior for step=0 not explained in documentation #5944

_.range & _.rangeRight behavior for step=0 not explained in documentation #5944

_.range & _.rangeRight behavior for step=0 not explained in documentation #5944

Comments